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效 子 版权 声 明 


图 灵 社 区 的 电子 书 没有 采用 专 有 客户 
端 ， 您 可 以 在 任意 设备 上 ， 用 自己 喜 
欢 的 浏览 器 和 PDF 阅读 器 进行 阅读 。 
但 您 购买 的 电子 书 仅 供 您 个 人 使 用 ， 
未 经 授权 ， 不 得 进行 传播 。 

我 们 愿意 相信 读者 具有 这 样 的 民 知 和 
觉悟 ， 与 我 们 共同 保护 知识 产权 。 
如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 对 
该 用 户 实施 包括 但 不 限于 关闭 该 帐号 
等 维权 措施 ， 并 可 能 追究 法 律 责任 。 
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DeNA 软 件 开发 工程 师 。 曾 做 过 IT 顾问 、 程 
序 员 ， 从 事 过 软件 包 开 发 、Web 服 务 开发 。 
Java 的 Web 应 用 框架 Play Framework 1 的 提 
交 者 。 负 责 本 书 第 1 章 ~ 第 5 章 ， 其 中 第 2 章 的 
案例 分 析 都 是 基于 自身 的 实际 经 验 编写 的 。 
Twitter @ikeike443 


苹 仓 和 明 

想 能 ( SHANON ) 基础 设施 工程 是。 负责 公 
司 内 部 基础 设施 及 服务 环境 的 安全 保障 ， 致 
力 于 推动 应 用 部 署 的 自动 化 ， 并 基于 这 方面 
丰富 的 实践 经 验 ， 完 成 了 本 书 第 6 章 。 喜 欢 
OpenVZ、LXC 等 容器 型 虚拟 化 技术 。 
Twitter @fujya 


井上 史 彰 

想 能 ( SHANON ) 软件 工程 师 、QA 工 程 师 ， 
现 为 想 能 信息 科技 (上海 ) 有 限 公司 总 经 理 
开发 经 验 丰 富 ， 致 力 于 推动 高 效 的 自动 化 测 
试 。 负 责 本 书 第 7 章 。 


E-mail fu.inoue@gmail.com 


严 圣 饮 

毕业 于 上 海 交通 大 学 。8 年 软件 开发 经 验 ， 
期 间 赴 日 本 工作 。 现 就 职 于 想 能 信息 科技 
( 上 海 ) 有 限 公 司 ， 从 事 基 于 云 平 台 的 客户 
关系 管理 及 各 类 营销 自动 化 系统 的 开发 ， 侧 
重 于 对 持续 集成 、 自 动 化 部 署 、 自 动 化 测试 
以 及 相关 的 开源 工具 的 研究 。 本 书 所 介绍 的 
即 是 译 者 日 常 工作 中 所 应 用 的 开发 流程 以 及 
工具 。 
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内 容 提 要 
本 书 以 团队 开发 中 所 必需 的 工具 的 导入 方法 和 使 用 方法 为 核心 , 对 团队 开发 的 
整体 结构 进行 概括 性 的 说 明 。 内容 涉及 团队 开发 中 发 生 的 问题 、 版 本 管理 系统 、 缺陷 
管理 系统 、 持 续集 成 持续 交付 以 及 回归 测试 , 并 且 对 “为 什么 用 那个 工具 ”“ 为 什么 
要 这 样 使 用 ”等 开发 现场 常 有 的 问题 进行 举例 说 明 。 

本 书 适合 所 有 想 要 系统 性 地 学 习 团 队 开 发 工具 的 人 阅读 。 
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致 中 文 版 的 读者 








感谢 您 购买 了 《高 效 团队 开发 : 工具 与 方法 》。 同样 要 感谢 已 经 决 
定购 买 本 书 的 读者 。 还 在 犹豫 是 否 购买 本 书 的 读者 ， 如 果 您 看 了 这 篇 序 
后 决定 购买 ， 那 将 没有 比 这 更 令 人 高 兴 的 事情 了 。 

本 书 是 由 我 、 想 能 ( SHANON ) 时 期 的 同事 芯 仓 和 明 先 生 与 井上 史 
彰 先生 共同 写作 的 。 这 次 是 受到 想 能 上 海 分 公司 总 经 理 井 上 先生 的 委托 
来 写 的 这 篇 序 。 
其 实 我 并 没有 去 过 中 国 大 陆 。 因 此 ， 从 真正 意义 上 来 说 ， 我 并 不 知 
中 国 软件 行业 的 真实 情况 。 当 然 ， 像 阿里 巴巴 和 腾讯 这 样 的 大 公司 还 
知道 的 ， 但 我 没有 在 中 国 工作 的 经 历 。 

中 国 的 软件 工程 师 极为 优秀 。 我 所 在 的 公司 就 有 很 多 非常 优秀 的 
中 国 工程 师 。OSS 社区 也 经 常 能 看 到 中 国 的 工程 师 ， 他 们 都 十 分 令 人 
敬佩。 

中 国 工程 师 无 疑 是 非常 出 众 的 ， 但 中 国 的 软件 开发 环境 是 怎样 的 
呢 ? 缺陷 管理 和 分 布 式 版 本 管理 的 运用 ,测试 代码 的 覆盖 和 CI 的 配备 ， 
部 署 的 自动 化 等 机 制 的 组 合 应 用 ， 这 些 我 听 说 都 还 刚刚 起 步 。 

您 所 在 的 开发 现场 又 是 怎样 的 呢 ? 

如 果 上 述 情 形 并 未 出 现在 您 的 开发 现场 中 ,那么 非常 抱 菊 ， 您 不 需 
要 这 本 书 。 请 将 这 本 书 放 回 书架 ， 回 去 继续 工作 。 如 果 存 在 上 述 情形 ， 
那么 本 书 将 对 您 有 所 帮助 。 

在 日 本 ， 能 够 构建 本 书 中 所 写 的 高 效 开发 环境 的 公司 和 无 法 构建 这 
样 的 环境 的 公司 之 间 有 着 很 大 的 差距 。 究 其 原因 ， 其 一 是 完备 的 环境 有 
助 于 提高 开发 效率 ， 能 够 迅速 地 发 布 优秀 的 产品 或 服务 ; 其 二 是 因为 工 
程 师 注 重 团队 开发 环境 是 否 完善 ， 开 发 环境 完善 的 公司 能 够 吸引 到 优秀 
的 工程 师 ， 而 优秀 的 工程 师 越 多 开发 效率 自然 就 越 高 。 这 样 一 来 ， 公 司 
之 间 的 差距 就 越 来 越 大 ， 这 就 是 日 本 的 真实 情况 。 

同样 的 情况 在 中 国 也 会 发 生 ， 或 许可 能 早 就 已 经 在 发 生 了 。 

团队 开发 环境 的 完善 就 像 “ 减 肥 ” 一 样 。 明 明知 道 只 要 去 做 就 会 有 
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效果 、 有 益处 ,但 却 迟 述 没 有 付 之 于 行动 。 往 往 会 以 太 忙 了 、 有 其 他 优 
先 度 更 高 的 工作 为 由 来 应 付 过 去 。 

本 书 第 2 章 讲 述 了 如 果 鳃 慢 这 个 “减肥 ”会 变 成 什么 情形 。 那 是 我 
过 去 的 真实 体验 ， 为 了 避免 重复 那样 的 经 历 ， 只 要 是 能 够 提高 团队 开 
发 效率 的 事情 ， 我 都 会 去 尝试 、 实 践 ， 而 本 书 就 是 这 些 尝试 和 实践 的 
结晶 。 

请 大 家 务必 阅读 、 学 习 本 书 ， 避 免 陷入 第 2 章 中 描述 的 悲惨 境地 。 
已 经 陷入 上 述 境地 的 各 位 ， 更 应 该 阅读 本 书 ， 以 便 能 够 从 上 述 境地 中 解 
脱出 来 。 

上 文 已 经 提 到 ， 在 日 本 是 否 能 够 实践 本 书 的 内 容 ， 决 定 了 公司 间 的 
差距 。 各 位 读者 也 请 学 习 、 实 践 本 书 的 内 容 ， 以 使 自己 所 在 的 公司 能 
苑 争 对 手 拉 开 差距 。 

如 果 您 的 实践 一 切 顺利 的 话 ， 请 告知 我 一 下 ， 我 们 可 以 一 起 去 喝 一 
杯 。 只 要 有 您 的 邀请 ， 我 随时 都 可 以 去 中 国 ! 我 非常 喜欢 绍兴 酒 ， 白 酒 
也 想 尝 试 一 下 :-) 






































作者 代表 ”池田 尚 史 
2014 年 11 月 15 日 于 千 叶 县 自家 
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《高 效 团队 开发 : 工具 与 方法 》 并 不 是 以 实际 的 项 目 带 你 体验 多 人 
开发 项 目的 整体 流程 ， 而 是 告诉 你 使 用 哪些 工具 和 方法 能 够 实现 高 效 的 
团队 开发 。 从 版 本 管理 系统 、 缺 陷 管 理 系统 到 CI 工具、 虚拟 化 、 上 自动 
化 测试 等 ， 无 论 你 使 用 哪 种 语言 、 框 架 、 软 件 开发 模式 ， 无 论 你 是 负责 
开发 、 测 试 ， 还 是 负责 运 维 、 项 目 管理 ， 都 会 涉及 这 些 工 具 。 这 些 工 具 
也 直接 影响 着 开发 和 运 维 的 效率 、 项 目 成 本 以 及 公司 的 日 常 开 销 。 

随 着 SaaS (〈 软件 即 服务 ) 的 普及 ， 越 来 越 多 的 项 目 已 经 不 是 经 过 一 
段 时 间 的 密集 开发 就 结束 的 了 。 后 期 的 开发 ， 包 括 集成 、 测 试 、 运 维 
(部署 、 发 布 等 )， 从 重要 性 以 及 成 本 的 角度 来 看 都 已 经 成 为 项 目 中 的 重 
要 部 分 。 本 书后 半 部 分 介绍 的 持续 集成 、 自 动 部 署 (持续 交付 ) 以 及 回 
归 测 试 ， 都 能 有 效 地 帮助 这 样 的 项 目 提 高 质量 、 加 快 开发 速度 、 降 低 运 
维 成 本 。 

本 书 让 我 印象 较 深 的 一 点 是 贯穿 全 书 的 自动 化 意识 ， 包 括 自动 化 环 
境 构 建 、 持 续集 成 、 自 动 化 测试 、 自 动 部 署 和 发 布 。 点 击 鼠 标 提交 代码 
和 测试 用 例 ， 借 助 CI 和 各 类 自动 化 工具 ， 自 动 触发 编译 、 集 成 、 测 试 、 
部 署 ， 还 会 自动 将 版 本 管理 系统 中 提交 的 信息 关联 到 缺陷 管理 和 CI 系 
统 中 ， 几 分 钟 后 打开 浏览 带 就 能 够 “享受 ”自己 的 劳动 成 果 了 。 这 样 的 
场景 实在 太美 了 。 想 来 是 因为 日 本 长 期 的 劳动 力 不 足 以 及 高 昂 的 劳动 力 
成 本 才 让 作者 对 于 自动 化 如 此 执着 。 对 于 还 能 够 享受 人 口红 利 的 中 国 软 
件 行业 来 说 ， 自 动 化 也 是 非常 必要 的 。 除 了 能 够 在 开发 、 测 试 、 运 维 等 
多 方面 降低 成 本 之 外 ， 自 动 化 环境 构建 、 自 动 化 测试 这 样 的 机 制 能 够 降 
低 项 目 对 于 成 员 个 体 的 依赖 ， 在 大 规模 的 团队 开发 中 以 及 在 灵活 调整 团 
队 规 模 方面 都 是 必 不 可 少 的 。 

本 书 所 介绍 的 内 容 对 于 公司 来 说 不 仅 可 以 提高 效率 ， 降 低 成 本 ， 还 
可 以 成 为 公司 的 一 张 名 片 。 持 续集 成 、 自 动 化 测试 、 持 续 交 付 ， 加 上 
Github 、Jenkins 、Vagrant 、Chef、serverspec 、Selenium 这 些 工具 ， 由 此 
构筑 起 的 技术 堆栈 ， 无 论 是 对 于 开发 、 测 试 人 员 还 是 运 维 人 员 来 说 都 是 
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非常 具有 吸引 力 的 。 对 于 个 人 来 说 ,除了 扩展 自己 的 知识 之 外 ， 还 能 作 
为 你 选择 公司 的 重要 参考 依据 判断 公司 是 否 对 技术 敏感 ， 推 测 项 目 大 
致 的 工作 流程 以 及 是 否 可 能 成 为 Death march。 更 重要 的 是 

员工 : “老板 ,我 要 加 工资 1” 














老板 :“ 为 什么 ?” 
员工 :“ 因 为 我 长 得 帅 1” 
老板 :“………” 


员工 :“ 因 为 我 跟 你 10 年 了 ,没有 功劳 也 有 苗 劳 吧 !1” 
老板 :“ 好 了 吧 ， 加 5% 差不多 了 。 
员工 :“ 这 个 项 目 交 给 我 ， 我 有 办 法 只 需要 一 半 的 人 手 束 能 完成 1” 
老板 :“ 真 的 ? 好 ! 工资 翻 倍 1” 
最 后 感谢 在 翻译 过 程 中 给 予 我 支持 及 鼓励 的 各 位 。 特 别 是 我 的 麦 
子 ， 翻 译 这 段 时 间 恰 好 是 她 怀孕 和 生产 的 时 候 。 我 们 平安 地 迎 来 了 家 里 














的 新 成 员 滚 滚 ， 借 此 祝愿 他 健康 成 长 。 
2015 年 3 月 于 上 海 
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本 书 名 为 《高 效 团队 开发 : 工具 与 方法 》 

读者 朋友 们 大 多 都 知道 ， 团 队 开发 是 一 件 复 杂 、 困 难 的 事情 。 

关于 团队 开发 ， 现 在 已 经 有 了 各 式 各 样 的 方法 论 和 工具 。 方 法 论 方 
面 ， 除 了 Scrum、XP 等 敏捷 开发 以 外 ， 还 有 些 更 具体 的 设计 开发 方法 ， 
如 TDD (Test Driven Development， 测 试 驱 动 开发 ) 、BDD (Behavior 
Driven Development, 行为 驱动 开发 )、TiDD ( Ticket Driven Development， 
缺陷 驱动 开发 ) 等 ， 以 及 具体 实践 ， 如 CI ( Continuous Integration， 持 
续集 成 )、CD ( Continuous Delivery， 持 续 交 付 ) 等 。 讲 述 这 些 方法 论 的 
书籍 、 杂 志 以 及 网 站 到 处 都 是 ， 甚 至 多 得 让 人 不 知 该 从 何 处 着 手 。 

再 看 一 下 从 技术 上 支持 这 些 方 法 论 的 工具 ,缺陷 管 理 系统 、 版 本 管 
理 系 统 、 自 动 化 测试 、 静 态 分 析 工 具 、 自 动 化 部 署 工具 等 ， 仅 是 种 类 就 
有 很 多 。 即 使 是 简单 地 列举 每 一 类 中 具有 代表 性 的 工具 ， 其 数量 就 多 得 
令 人 感到 头 学 。 

并 且 和 数 年 前 相 比 ， 支 持 团 队 开 发 的 工具 已 经 变 得 非常 易 用 ， 能 方 
便 地 构建 高 效 的 开发 流程 。 但 由 于 信息 量 过 多 ， 并 且 很 分 散 ， 所 以 想 要 
系统 性 地 学 习 或 者 对 新 人 进行 高 效 的 培训 都 还 是 比较 困难 的 。 正 是 因为 
意识 到 了 上 述 这 些 问 题 ， 笔 者 才 有 了 写作 本 书 的 想法 。 

本 书 以 团队 开发 中 所 必需 的 工具 的 导入 方法 和 使 用 方法 为 重点 ， 对 
团队 开发 的 整体 结构 进行 概括 性 的 说 明 。 并 且 对 “为 什么 用 那个 工 
具 ” “为 什么 要 这 样 使 用 ”等 开发 现场 常 有 的 一 些 问题 进行 举例 说 明 。 

希望 你 能 喜欢 本 书 。 


读者 对 象 
本 书 适合 的 读者 对 象 有 : 































































































































































































@ 初次 接手 开发 团队 的 项 目 经 理 
@ 计划 开始 新 项 目的 项 目 经 理 、Scrum Master 
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@ 现 有 项 目 中 返工 、 延 期 问题 频 发 ， 想 了 解 能 帮助 自己 解决 这 些 问 
题 的 工具 及 其 使 用 方法 的 人 

@ 测试 是 测试 部 门 的 事 ， 与 己 无 关 ; 部 署 、 发 布 是 运 维 部 门 的 事 ， 
与 己 无 关 一 一 有 如 此 想法 的 人 

@ 想 了 解 最 近 能 够 在 Web 服务 开发 中 发 挥 作用 的 工具 的 人 
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1.1 一 个 人 也 能 进行 开发 





想必 大 家 都 知道 ， 一 个 人 也 可 以 进行 软件 开发 。 自 由 软件 以 及 共享 
软件 的 开发 人 员 大 多 都 是 个 人 开发 者 。 这 几 年 来 ,以 个 人 形式 开发 
iPhone 应 用 或 Android 应 用 并 一 炮 而 红 的 开发 者 也 不 在 少数 。 网 上 也 有 
一 些 个 人 开发 的 作为 OSS( Open Source Software ) 的 实用 小 工具 。 

笔者 从 自己 的 兴趣 出 发 ,偶尔 也 会 写 一 些 Jenkins” 和 Sublime Text” 
插件 与 大 家 共享 。 一 个 人 进行 软件 开发 的 情况 下 ， 因 为 没有 沟通 成 本 ， 
所 以 能 够 迅速 地 开发 并 发 布 。 在 软件 规模 ” 较 小 的 前 提 下 ， 全 部 流程 由 
一 个 人 把 控 还 是 可 能 的 。 

但 是 如 果 软 件 的 规模 超过 一 定 程度 ， 仪 由 一 个 人 把 控 产 品 的 所 有 内 
容 就 比较 困难 了 。 不 难 想 象 ， 这 时 候 就 需要 由 多 人 组 成 团队 进行 开发 。 

而 且 人 们 对 于 软件 产品 的 要 求 越 来 越 高 ， 因 此 软件 开发 ， 特 别 是 在 
企业 内 部 的 开发 现场 ， 由 多 人 组 成 团队 进行 开发 是 非常 普遍 的 。 

本 书 将 由 多 人 开发 程序 的 体制 称 为 团队 开发 。 






























































D http://jenkins-ci.org/ 
© http:/www.sublimetext.com/ 
加 ”衡量 软件 规模 的 指标 有 很 多 种 ,例如 用 户 数 、 功 能 数 、 代 码 行 数 等 。 
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1.2 团队 开发 面临 的 问题 


随 着 开发 的 进行 ， 团 队 会 遇 到 各 式 各 样 的 问题 : 团队 内 部 对 遇 到 的 
问题 没有 共享 、 项 目 进 度 无 法 掌控 、 多 人 编写 同一 个 产品 的 代码 造成 开 
发 内 容 冲 突 等 。 而 且 由 于 涉及 多 个 人 ， 所 以 代码 质量 的 统一 以 及 产品 代 
码 的 整体 把 控 都 变 得 越发 困难 。 

如 今 的 软件 开发 已 经 不 是 一 旦 发 布 (release ) 就 意味 着 开发 结束 这 
样 的 模式 了 。 很 多 情况 下 都 需要 在 运营 的 过 程 中 不 断 地 更 新 。 因 此 , 在 
这 样 一 段 较 长 的 时 间 中 ， 有 必要 将 一 个 人 难以 完成 的 代码 交 由 多 个 人 并 
行 修改 , 并 且 要 在 一 定 程度 上 保证 代码 品质 , 防止 退化 ( degrade ) "， 同 
时 还 要 不 断 地 增加 新 的 功能 。 

人 是 会 犯错 并 且 容 易 遗 忘 的 生物 。 微 小 的 失误 就 可 能 造成 系统 的 退 
化 ， 并 且 对 复杂 的 软件 进行 全 方位 、 训 无 遗漏 的 测试 也 是 不 可 能 的 ， 而 
由 多 个 人 进行 开发 还 有 可 能 出 现 内 容 上 相互 矛盾 的 代码 。 即 使 是 自己 1 
个 月 前 写 的 代码 ， 也 有 可 能 完全 忘记 ， 甚 至 错 认 为 是 别人 写 的 代码 。 

















































































































中 添加 新 功能 或 修正 bug 造成 之 前 正常 运行 的 其 他 功能 无 法 运行 或 者 运行 速度 变 慢 
的 现象 。 
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1.3 如何 解决 这 些 问题 


要 解决 团队 开发 所 面临 的 问题 ， 仅 仅 靠 努 力 是 行 不 通 的 。 全 世界 的 
工程 师 们 为 了 解决 类 似 的 问题 而 开发 了 各 类 工具 和 方法 论 ， 除 了 对 其 加 
以 有 效 利用 之 外 别 无 他 法 。 

在 多 个 人 之 间 共 享 问题 ， 将 所 发 生 的 事情 以 简明 易 懂 的 方式 公开 ， 
以 及 为 了 防止 退化 发 生 ， 执 行 自动 化 测试 ,这些 都 是 非常 重要 的 。 除 此 
以 外 ,一 旦 发 生 错 误 ， 能 够 立即 回 深 到 之 前 的 状态 也 极其 关键 。 男 一 方 
面 ， 如 果 不 能 迅速 地 开发 新 功能 并 发 布 ， 就 会 在 激烈 的 市 场 兖 争 中 败 下 
阵 来 ， 所 以 还 必须 并 行 地 开发 多 个 功能 。 当 然 这 些 都 是 以 保证 质量 为 前 
提 的 。 

综 上 可 见 ， 团 队 开发 绝 非 易 事 。 为 了 团队 开发 能 够 顺利 地 推进 ， 以 
下 几 点 是 必 不 可 少 的 。 

































































e“ 谁 ”“ 到 何 时 为 止 ”做 了 “什么 事情 “怎样 ” 才 算 “ 完 成 ” 
等 ， 必 须 对 这 样 的 信息 进行 管理 和 共享 

e 代码 等 各 类 工作 成 果 ， 必 须 在 团队 内 部 共享 

e 管理 工作 成 果 的 变更 ， 既 要 防止 成 果 被 破坏 ， 又 要 保证 各 成 员 能 
够 利用 成 果 并 行 地 作业 

e 在 团队 中 共享 从 项 目 中 学 到 的 知识 

e 证 明 团 队 开发 出 的 软件 在 任何 时 候 都 是 可 以 正常 运行 的 

e 构建 任何 人 都 可 以 正确 开发 、 测 试 、 发 布 的 自动 化 工作 流程 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 





1.4 ”本 书 的 构成 | 5 





1.4 本 书 的 构成 








为 了 解决 上 述 课 题 ， 本 书 将 对 各 类 工具 及 其 使 用 方法 进行 讲解 。 


1.4.1 第 2 章 : 案例 分 析 

在 讲解 的 顺序 上 ， 首 先 为 了 了 解 诸 事 不 顺 、 无 法 顺利 进行 的 项 目 究 
竟 是 怎样 的 ， 我 们 将 在 第 2 章 模拟 在 参与 某 个 项 目的 两 天 时 间 内 所 发 生 
的 事情 ; 然后 介绍 如 何 解 决 在 这 两 天 时 间 中 出 现 的 问题 ， 并 从 之 后 的 第 
3 章 开始 对 相应 的 工具 进行 讲解 。 




















1.4.2 第 3~5 章 :基础 实践 





从 第 3 章 开 始 ， 将 依次 介绍 改善 团队 开发 中 需要 进行 的 工作 。 各 位 
读者 可 以 按 顺 序 阅读 ， 并 逐个 实行 。 

第 3 章 是 关于 版 本 管理 系统 ( Version Control System ，VCS ) 的 
内 容 。 想 必 大 多 数 人 已 经 在 使 用 版 本 管理 系统 了 。 本 章 将 在 回顾 版 本 
管理 系统 飞速 发 展 的 历史 的 同时 ， 以 git-flow 和 GitHub-flow 这 两 个 具 
有 代表 性 的 工作 流程 为 例 ， 对 当下 最 流行 的 分 布 式 版 本 管理 系统 的 使 
] 方 法 进行 讲解 。 后 面 在 内 容 上 还 更 进一步 ， 讲 解数 据 库 模 式 变更 管 
理 的 重要 性 。 

第 4 章 是 关于 缺陷 管理 系统 ( Issue Tracking System/Bug Tracking 
System，ITS/BTS ) 的 内 容 。 这 里 的 缺陷 管理 是 指 将 完成 项 目 所 必需 的 
任务 (task ) 以 bug 票 的 形式 进行 管理 。 包 括 商 用 软件 在 内 ， 缺 陷 管 理 
工具 的 数量 很 多 ， 让 人 不 知 该 如 何 挑选 ， 因 此 这 里 将 介绍 一 些 挑选 时 的 
要 点 。 这 一 章 还 探讨 了 结合 使 用 缺陷 管理 和 版 本 管理 系统 所 带 来 的 优 
势 ， 以 及 使 用 缺陷 管理 系统 时 课题 的 颗粒 度 问题 。 
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第 5 章 是 关于 持续 集成 ( Continuous Integration，CI ) 的 内 容 。 估 计 
很 多 开发 现场 都 已 经 使 用 了 版 本 管理 系统 和 缺陷 管理 系统 ， 但 还 没有 使 
用 CI。 进 入 测试 阶段 后 ， 首 次 下 载 所 有 修改 的 代码 并 试 着 编译 时 ， 发 现 
编译 错误 ,或 者 程序 无 法 启动 ， 有 如 此 经 历 的 读者 想必 不 在 少数 吧 。 

为 了 避免 上 述 问 题 ， 就 需要 导入 CI。CI 会 持续 地 下 载 代码 的 变更 
或 者 依赖 关系 的 变更 等 所 有 变更 内 容 并 进行 编译 。 导 入 CI 可 以 同时 提 
高 开发 速度 及 质量 。 这 章 将 讲解 实施 CI 所 必要 的 编译 工具 、 测 试 框架 
以 及 CI 工具 。 

到 第 5 章 为 止 ， 都 是 在 讲述 为 了 顺利 推进 团队 开发 所 需 的 基础 实 
践 。 请 认真 阅读 前 5 章 ， 并 试 着 实际 操作 一 下 。 在 前 5 章 的 内 容 已 经 全 
部 实现 的 开发 现场 ， 如 果 要 进一步 推进 团队 开发 ， 就 需要 用 到 从 第 6 章 
开始 介绍 的 内 容 。 

















































































































1.4.3 第 6~7 章 : 持续 交付 和 回归 测试 





第 6 章 是 关于 持续 交付 ( Continuous Delivery，CD ) 的 内 容 。 这 里 
将 对 能 够 进行 自动 化 环境 构建 ， 并 结合 CI 实践 在 任意 时 间 、 重 复 地 将 
运行 的 程序 发 布 到 正式 环境 中 的 机 制 进行 讲解 。 

第 7 章 是 关于 回归 测试 的 内 容 。 反 复 从 用 户 角度 运行 用 户 验 收 测 
试 ， 以 此 来 确保 没有 退化 发 生 ， 这 是 实现 快速 产品 发 布 中 必 不 可 少 的 环 
节 。 本 章 将 讲解 使 用 Selenium 和 Jenkins 来 实现 回归 测试 的 自动 化 ， 还 
将 进一步 介绍 为 了 加 快 测试 速度 所 需要 的 分 布 式 测试 环境 的 搭建 。 
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1.5 阅读 本 书 前 的 注意 事项 














选择 团队 开发 中 所 使 用 的 工具 和 方法 论 ， 并 没有 唯一 且 绝 对 正确 的 
答案 。 根 据 企业 规模 、 产 品 规模 、 团 队 规模 的 不 同 ， 最 合适 的 工具 和 方 
法 论 也 不 尽 相 同 。 而 且 ， 团 队 开 发 的 工具 、 方 法 论 的 选择 范围 也 非常 
大 ， 但 这 并 不 意味 着 全 都 要 使 用 。 
































1.5.1 最 好 的 方法 是 具体 问题 具体 分 析 


在 团队 开发 的 世界 中 ,没有 到 哪 都 适用 的 万 能 的 最 佳 实践 ， 只 有 根 
据 实际 情况 制定 的 方案 才能 行 得 通 ， 这 样 的 思考 方法 才 是 比较 正确 的 。 
是 否 能 找到 最 适合 自己 所 从 事项 目的 解决 方案 ， 可 以 说 是 能 否 将 项 目 导 
向 成 功 的 关键 所 在 。 

例如 ， 在 实际 的 项 目 中 ， 有 需要 将 缺陷 管理 系统 、 版 本 管理 系统 、 
CI、CD 这 些 方法 全 部 使 用 的 ， 也 有 只 需要 版 本 管理 和 CI 就 足够 的 。 
















































































1.5.2 ”没有 最 好 的 工具 





在 工具 的 选择 方面 也 没有 正确 的 答案 。 仅 以 缺陷 管理 系统 来 说 ， 是 
使 用 Redmine" 好 ,还 是 使 用 JIRA2 好 呢 ? 或 者 是 只 使 用 GitHub” 就 足够 
了 呢 ? 答案 会 因 具 体 的 情况 不 同 而 发 生变 化 。 

CI 的 情况 也 一 样 ， 是 使 用 Jenkins 好 还 是 使 用 Travis CI 好 , 或 者 是 
使 用 其 他 的 工具 比较 好 ， 不 能 一 概 而 论 。 至 于 CD， 如 今 也 有 各 类 工具 
相继 推出 ， 哪 个 是 最 好 的 还 很 难说 。 





















































OD http:/www.redmine.org/ 

©® https//www.atlassian.com/ja/software/jira 
® https://github.com/ 

@ https://travis-ci.org/ 
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想 要 在 本 书 中 一 一 介绍 各 类 方法 和 工具 的 所 有 组 合 模 式 是 不 可 能 
的 ， 所 以 本 书 将 主要 讲解 本 书写 作 时 (2014 年 3 月 ) 的 一 些 优秀 的 模 
式 。 如 果 有 多 个 选项 的 话 ， 也 将 尽量 向 读者 们 展示 。 

在 接 下 来 的 第 2 章 中 ,我们 将 围绕 诸 事 不 顺 、 无 法 顺利 推进 的 项 目 
案例 展开 ， 一 起 思考 该 如 何 改善 这 种 情况 。 
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2.1 案例 分 析 的 前 提 


















































用 于 高 效 推进 团队 开发 的 各 类 工具 和 方法 数量 众多 。 工 具 的 话 有 版 
管理 系统 (Version Control System，VCS ) 和 缺陷 管理 系统 ( Issue 
Tracking System 、Bug Tracking System，ITS/BTS )。 方法 的 话 有 持续 
集成 (Continuous Integration，CI) 以 及 最 近 比 较 热门 的 持续 交付 
( Continuous Delivery, CD ), 

为 什么 需要 这 些 工具 和 方法 ?为 了 回答 这 个 问题 ,我们 先 要 知道 如 
不 使 用 这 些 工 具 和 方法 论 ， 项 目 会 怎么 样 。 

本 章 将 对 陷入 死亡 行军 "状态 项 目的 两 天 时 间 进行 案例 分 析 ， 看 一 
下 类 似 这 样 的 项 目 中 容易 出 现 的 现象 ， 随 后 反思 其 中 存在 的 问题 。 并 以 
此 为 基础 ， 从 第 3 章 开 始 讲解 具体 的 应 对 方法 。 










































































2.1.1 项 目的 前 提 条 件 


本 章 所 涉及 的 项 目的 前 提 条 件 如 下 。 





e 系统 由 网 站 + 数据库 构成 
e 不 仅仅 要 进行 开发 ， 发 布 后 还 需要 持续 地 进行 版 本 更 新 和 运 维 等 


各 位 可 以 想象 一 下 自己 身 处 自行 开发 并 负责 运 维 互 联网 服务 的 企 
业 ， 或 者 负责 开发 企业 内 部 业务 系统 的 软件 部 门 时 的 情形 。 





QD 项 目 发 发 可 危 ， 开 发 人 员 身 心 俱 疲 的 状态 。 
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2.2 ”案例 分 析 (第 1 天 ) 





某 天 早晨 你 去 公司 上 班 ， 觉 得 这 是 一 个 郁闷 的 早晨 ， 总 想 着 “好 讨 
大 啊 ”。 为 什么 会 觉得 厌烦? 因为 你 所 参加 的 项 目 陷入 了 发 发 可 和 危 的 状 
况 ， 俗称 “死亡 行军 ”。 

“但 仔细 想来 ， 不 是 死亡 行军 的 项 目 至 今 为 止 还 没有 遇 到 过 ”你 如 
此 思考 着 ,“ 可 哪里 出 问题 了 呢 ?” 你 边 想 边 去 上 班 。 














2.2.1 ”问题 1 : 重要 的 邮件 太 多 ， 无 法 确定 处 理 的 优先 顺序 


你 想 着 想 着 就 到 了 公司 ， 打 开 邮 件 客户 端 ， 便 看 到 下 面 这 样 小 题 大 
作 的 邮件 主题 。 











e【 重要 】 系 统 报错 导致 工作 无 法 进行 ， 请 立即 着 手 处 理 ! 

e【 加 急 】 正 式 环 境 发 生 重大 故障 ! 麻烦 立即 处 理 。 

e【 需要 处 理 】 客 户 环境 发 生 重大 退化 。 请 尽快 处 理 。 

e【 正式 环境 故障 】【 重要 】【 加 急 】【 立即 处 理 】 收 到 用 户 投诉 。 请 
立即 处 理 。 


看 到 这 些 五 花 八 门 的 邮件 主题 ， 虽 然 你 已 经 感到 烦躁 无 比 ， 但 还 是 
要 着 手 确认 邮件 的 内 容 。 但 是 所 有 的 邮件 主题 都 标 有 【重要 】 或 【加 
急 】 等 字样 ， 完 全 不 知道 应 该 从 哪里 着 手 ， 所 以 只 能 依次 阅读 收 到 的 邮 
件 并 着 手 处 理 。 
































2.2.2 问题 2 : 没有 能 用 于 验证 的 环境 





为 了 确认 邮件 中 反映 的 问题 ， 首 先 不 得 不 构建 和 发 生 故障 的 正式 环 
境 相同 的 环境 。 因 为 这 个 项 目 一 开始 就 没有 准备 用 于 验证 的 环境 。 
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再 现 正 式 环境 中 发 生 的 问题 ， 必 须 首先 再 现 与 正式 环境 相同 的 环 
境 。“ 要 是 有 一 直 和 正式 环境 保持 同步 状态 ”的 验证 用 的 环境 , 故障 的 再 
现 就 能 简单 多 了 ”你 一 边 想 着 ， 一 边 无 可 奈何 地 开始 在 本 地 机 器 上 搭建 
和 正式 环境 一 样 的 环境 。 














2.2.3 问题 3 : 用 别名 目录 管理 分 支 





由 于 到 昨天 为 止 一 直 在 开发 新 功能 ， 自 己 本 地 机 器 上 的 代码 和 正式 
环境 的 代码 已 经 相差 其 远 ， 所 以 只 好 将 本 地 机 器 上 的 正在 开发 的 代码 所 在 
的 目录 重 命名 为 “XXX _new”， 再 从 版 本 管理 系统 下 载 最 新 的 代码 。 不 这 
样 的 话 ， 版 本 管理 系统 上 的 最 新 代 人 码 就 会 和 本 地 的 代码 混淆 ( 图 2.1 )。 


2 将 目录 重 命名 































































































国 LocalApp_Honban ( 正式 环境 的 副本 ) 














其 实 公 司 从 数 年 前 就 开始 使 用 版 本 管理 系统 了 ， 但 由 于 开发 人 员 中 
没有 人 精通 版 本 管理 系统 的 使 用 方法 ， 所 以 并 没有 对 其 加 以 有 效 利用 。 

版 本 管理 系统 上 经 常 只 有 最 新 的 代码 。 那 是 因为 没有 有 效 地 利用 分 
支 功 能 ， 为 了 区 分 本 地 机 器 上 的 代码 和 版 本 管理 系统 上 的 最 新 代码 ， 只 
能 用 给 目录 重 命名 这 种 方式 。 合 理 地 利用 版 本 管理 系统 就 应 该 能 解决 这 
些 问 题 ， 但 又 不 知道 该 如 何 操作 。 加 上 因为 不 知道 标签 (tag ) 的 使 用 方 
法 ， 发 布 时 的 系统 快照 也 没 能 保存 下 来 。 而 且 版 本 管理 系统 上 的 最 新 代 









































GD 实际 上 要 再 现 的 环境 包括 服务 器 台数 、 网 络 构成 以 及 数据 库 事务 数据 ， 但 要 将 全 
部 内 容 都 做 得 和 正式 环境 完全 一 致 是 非常 困难 的 。 本 书 中 指 的 是 应 用 程序 层面 上 
的 再 现 ， 也 就 是 指 程序 的 代码 、 数 据 库 模 式 ( schema )、 中 间 件 的 配置 等 。 
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码 还 有 可 能 已 经 和 正式 环境 的 代码 有 了 差异 ， 毕 竟 向 正式 环境 进行 发 布 
已 经 是 两 周 前 的 事情 了 。 
因为 没有 使 用 标签 ， 所 以 正式 环境 发 布 的 版 本 对 应 版 本 管理 系统 中 
哪个 版 本 “已 经 无 从 知晓 。 没 有 办 法 ， 只 能 麻烦 负责 运 维 的 人 将 正式 环 
境 的 代码 取 了 下 来 。 
自己 试 着 比较 了 最 新 的 代码 和 正式 环境 中 的 代码 ， 的 确 有 所 差异 “。 
在 最 新 代码 的 环境 中 ， 故 障 似乎 已 经 无 法 再 现 (图 2.2 )。 























图 2.2 ”正式 环境 和 开发 环境 产生 差异 


| 正式 环境 ae 
和 向 正式 环境 发 布 ， 册 于 其 他 并 发 四 中 
(两 周 前 ) 员 的 这 两 次 提交 。 故障 发 生 的 时 候 ， 代 码 库 
， 造成 了 同 正式 环 的 最 新 状态 和 正式 环境 的 
















































































ee ee 


全 本 
【全 地 PC 】 ;提交 代码 本 地 机 器 上 的 这 3 个 提交 被 
. 新 功 能 的 开发 ， 各 代 模 库 以 及 正 
从 代码 库 ， 式 环境 部 不 相同 





















































(中 因为 发 布 的 时 候 没 有 打上 标签 ， 
所 以 无 法 迅速 地 再 现 向 正式 环境 发 布 时 的 代码 库 快照 


(@) 因 为 开发 的 时 候 没有 切换 分 支 ， 
所 以 当 本 地 代码 和 代码 库 产生 差异 时 ， 不 得 不 给 目录 重 命名 




















































































































GD 这 里 使 用 了 “版 本 ”这 个 词 ， 在 Subversion 中 指 的 是 “版 本 号 ”(revision )， 在 
Git 中 指 的 是 “提交 哈 希 ”( commit hash )。 各 版 本 管理 系统 的 叫 法 不 相同 ， 所 以 
这 里 统称 为 “版 本 ”。 

@) 这 个 例子 假定 的 是 PHP 等 脚本 语言 。Java 或 C# 的 情况 下 ， 除 了 Play Framework 等 
一 部 分 情况 例外 ， 通 常 部 署 的 都 是 编译 后 的 二 进 制 文 件 ， eh 
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无 法 再 现 故障 的 代码 就 没有 意义 ， 所 以 你 决定 继续 使 用 从 正式 环境 
获取 的 代码 。 用 这 份 代码 在 本 地 机 器 上 构建 环境 可 不 是 一 件 容 易 的 事 
情 。 还 必须 保证 数据 库 模式 和 正式 环境 完全 相同 ， 而 重新 制作 数据 库 也 
是 一 件 非常 麻烦 的 工作 。 














2.2.4 问题 4 : 重新 制作 数据 库 比 较 困 难 


为 了 使 数据 库 和 正式 环境 完全 相同 ， 需 要 下 载 版 本 管理 系统 的 代码 
库 中 的 SQL， 并 在 自己 的 开发 环境 上 构建 数据 库 。 刚 才 还 在 使 用 的 用 于 
功能 开发 的 数据 库 的 模式 已 经 和 正式 环境 的 数据 库 模 式 不 一 样 了 。 仔 
细 看 了 下 下 载 下 来 的 SQL， 总 觉得 有 一 些 SQL 并 不 适用 于 开发 环境 。 

不 知道 该 执行 哪些 SQL 才能 构建 和 正式 环境 完全 相同 的 数据 库 。 
是 否 有 必要 记录 下 执行 了 哪些 SQL 呢 ? 没 办 法 ， 姑 且 只 能 根据 推测 执 
行 SQL， 想 办 法 试 着 构建 环境 了 。 也 不 知道 是 否 能 正确 地 再 现 正式 环 
境 ， 不 过 也 只 能 这 样 了 。 

数据 库 构 建 完 后 ， 为 了 再 现 和 正式 环境 相同 的 状态 ， 还 需要 导入 数 
据 。 可 是 在 将 正式 环境 的 数据 "导入 刚才 构建 的 数据 库 时 ， 不 知 为 何 部 
分 数据 的 导入 失败 了 。 应 该 是 数据 库 模 式 不 同 的 原因 吧 。 总 觉得 正式 环 
境 的 模式 和 刚才 在 本 地 构建 的 模式 有 所 差异 。 虽 然 不 清楚 是 为 什么 , 但 
鉴于 时 间 也 所 剩 无 几 了 ， 只 能 自己 用 眼睛 来 寻找 差异 ， 并 修改 SQL， 然 
后 重新 构建 数据 库 了 。 重 新 导入 数据 ， 这 次 终于 成 功 了 。 

代码 和 数据 库 都 准备 好 后 就 可 以 试 着 运行 程序 了 。 赶 紧 依 照 报 告 中 
的 描述 操作 一 遍 ， 却 发 现 程序 无 法 正常 运行 ， 并 且 和 报告 中 描述 的 现象 
也 不 一 样 。 

为 了 再 现 故 障 而 试 着 搭建 环境 ， 但 因为 出 现 了 其 他 问题 ， 结 果 以 失 
败 告终 。 怒 怕 还 是 因为 数据 库 模 式 和 正式 环境 不 一 样 吧 。 以 为 仔细 点 就 
能 避免 上 述 问题 的 ， 结 果 还 是 不 行 。 没 办 法 ， 只 能 将 正式 环境 的 数据 库 
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@ 这 里 的 数据 是 指正 式 环境 的 主 数据 (master data )。 关 联 数 据 (transaction data ) 
因为 数据 量 过 大 ， 应 避免 直接 导入 本 地 环境 。 
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原封 不 动 地 复制 到 开发 环境 了 "。 

终于 搭建 好 了 和 正式 环境 完全 相同 的 环境 ， 突 然 发 现 已 经 是 中 午 
了 。 已 经 过 去 了 两 个 多 小 时 ， 可 是 连 邮件 中 反映 的 问题 是 否 能 再 现 都 还 
没 确认 。 

当天 下 午 和 同事 们 分 头 把 早晨 4 封 邮件 中 的 问题 全 部 再 现 了 ， 用 了 
1 天 的 时 间 修 正 这 4 件 bug， 并 将 其 提交 到 版 本 管理 系统 。 做 完 这些 已 
经 快要 到 末班车 的 时 间 了 。 今天 一 整 天 都 在 忙 着 处 理 这 些 问 题 ， 本 来 应 
该 进行 的 新 功能 开发 也 完全 没有 着 手 。 算 了 ， 明 天 再 干 吧 ， 回 家 了 。 





























@ 这 个 例子 中 ， 正 式 环境 的 数据 量 并 不 是 太 大 ， 所 以 可 以 复制 。 如 果 是 大 规模 服务 
的 话 ， 复 制 是 不 现实 的 。 为 了 避免 上 述 问题 ， 需 要 考虑 数据 库 的 管理 。 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 














16 | 第 2 章 团队 开发 中 发 生 的 问题 














2.3 ”案例 分 析 ( 第 1 天 ) 中 的 问题 点 
































看 了 死亡 行军 项 目 中 的 1 天， 感觉 怎么 样 ?“ 项 目 一 直 都 是 这 样 的 ， 
已 经 习惯 了 ”是 不 是 也 有 人 这 么 想 呢 ? 

反思 第 1 天 中 发 生 的 事情 ， 让 我 们 一 起 来 确认 下 到 底 哪里 有 问题 ， 
哪里 做 得 不 够 好 。 

















2.3.1 问题 1 : 重要 的 邮件 太 多 ， 无 法 确定 处 理 的 优先 顺序 


这 个 项 目 中 没有 对 课题 进行 管理 的 机 制 (缺陷 管理 系统 )， 所 以 只 
能 通过 邮件 来 发 送 有 关 bug 或 故障 的 报告 。 加 上 邮件 的 主题 中 写 有 【 重 
要 】[ 加 急 】[ 需要 处 理 ] 这 样 的 标题 头 ， 所 有 的 邮件 都 变 得 很 重要 ， 不 
知道 应 该 从 何 处 开始 着 手 处 理 。 这 样 的 邮件 满天飞 的 开发 现场 你 有 没有 
街 过 呢 ?“ 遇 到 过 遇 到 过 ”似乎 还 能 听 到 这 样 的 回答 。 

不 使 用 缺陷 管理 系统 ， 而 通过 邮件 进行 交流 会 有 哪些 问题 ?下面 就 
来 列举 一 些 。 





















































e@-…… 邮件 的 数量 太 多 ， 导 致 重要 的 邮件 被 埋没 


大 家 在 开发 现场 1 天 之 中 所 收发 的 邮件 数量 大 概 有 多 少 呢 ? 当然 数 
量 会 根据 公司 的 规模 和 职位 有 所 不 同 。 以 笔者 为 例 ， 笔 者 之 前 所 在 的 公 
司 中 ， 与 自己 所 参与 的 项 目 相关 的 邮件 以 及 其 他 邮件 加 起 来 ，1 天 之 中 
大 约 要 收 到 300 一 400 封 邮件 。 该 公司 的 规模 未 满 100 人 ， 参 与 项 目 开 
发 的 人 员 在 10 人 左右 。 笔 者 当时 还 兼任 部 门 主管 ， 所 以 会 有 人 事 相 关 
的 邮件 以 及 其 他 的 一 些 被 抄 送 的 邮件 ， 这 也 是 邮件 比较 多 的 原因 之 一 。 

也 就 是 说 ， 参 加 项 目的 人 员 不 可 能 都 专门 进行 这 一 个 项 目 ， 其 中 很 
多 都 还 有 其 他 的 日 常 业务 ， 或 者 兼任 着 其 他 项 目的 工作 。 因 此 必然 会 产 
生 大 量 的 邮件 ， 造 成 重要 的 邮件 被 埋没 ， 容 易 被 漏 看 。 
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为 了 让 自己 的 邮件 不 被 漏 掉 ， 很 多 人 都 会 在 邮件 的 主题 前 加 上 之 前 
列举 的 那些 标题 头 。 但 是 因为 没有 统一 的 规则 ， 究 竟 哪 些 是 重要 的 无 从 
知晓 。 结 果 还 是 被 埋没 在 了 成 堆 的 邮件 中 ， 添 加 的 标题 头 也 完全 失去 了 
意义 。 























@…… 无 法 进行 状态 管理 


因为 邮件 并 非 是 用 来 管理 课题 或 任务 的 软件 ， 所 以 不 能 对 其 状态 进 
管理 。 哪 个 课题 已 经 结束 了 ， 哪 个 课题 还 在 进行 中 ， 或 者 是 验证 不 通 
被 退回 来 了 ， 这 些 都 无 法 简单 地 获知 。 如 果 不 耐 心地 一 封 一 封地 阅读 
司 一 主题 的 往来 邮件 ， 就 不 知道 究竟 是 怎样 的 问题 。 有 时 就 算 读 到 了 最 
后 ， 因 为 来 来 回回 的 交互 过 于 错综复杂 ， 究 竞 结局 怎样 也 还 是 不 清楚 。 
这 也 是 常 有 的 事 。 











行 




















@…… 直观 性 、 检 索性 较 弱 


这 一 问题 同上 一 个 问题 是 相关 的 ， 那 就 是 用 邮件 进行 管理 在 直观 性 
和 检索 性 方面 也 比较 弱势 。 邮 件 中 包含 了 很 多 和 项 目 没有 直接 关系 的 内 
容 ， 想 看 只 包括 课题 的 列表 ， 这 样 的 要 求 估计 无 法 实现 。 检 索 也 是 这 
样 。 也 可 以 使 用 像 Gmail 这 样 的 邮件 应 用 程序 ， 但 像 这 样 用 全 文 检索 来 
查找 课题 可 以 说 实在 是 效率 太 低 了 。 











e…… 用 邮件 来 管理 项 目的 课题 


总 结 一 下 上 述 内 容 就 是 : 邮件 的 可 视 性 不 佳 ， 难 以 进行 优先 度 或 重 
要 度 的 判断 ， 并 且 无 法 进行 状态 管理 ， 不 支持 显示 课题 列表 、 检 索 等 ， 
所 以 作为 管理 项 目 状况 的 工具 来 说 ， 功 能 上 是 不 足 的 。 

项 目 混乱 是 由 于 某 些 问 题 造 成 的 ， 其 中 一 个 比较 严重 的 问题 就 是 这 
里 列举 的 没有 共享 信息 及 有 效 管理 课题 的 机 制 。 

上 述 问 题 可 以 考虑 通过 导入 缺陷 管理 系统 来 解决 。 本 书 的 第 4 章 将 
讲解 在 使 用 了 缺陷 管理 系统 的 项 目 中 任务 管理 和 bug 管理 的 方法 。 
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2.3.2 ”问题 2 : 没有 能 用 于 验证 的 环境 














没有 能 用 于 验证 的 环境 可 以 说 是 一 个 大 问题 。 在 收 到 项 目 正 式 环境 
中 发 生 的 故障 报告 后 ， 下 载 代码 并 搭建 开发 环境 的 做 法 每 次 都 要 花费 较 
长 时 间 。 

只 要 不 影响 新 功能 开发 的 任务 不 就 没事 了 ? 但 现实 往往 没 这 么 简 
单 。 除 了 发 布 后 的 正式 环境 之 外 ,一般 还 有 为 下 一 次 发 布 做 准备 的 ， 还 
在 验证 中 的 staging 环境 “， 甚 至 还 有 为 下 下 次 发 布 准备 的 环境 。 

新 功能 开发 过 程 中 有 时 不 得 不 调查 正式 环境 中 发 生 的 一 些 故障 。 如 
有 一 直 和 正式 环境 保持 一 致 的 staging 环境 那 就 最 好 了 ， 但 因为 环境 
的 搭建 实在 是 件 非 常 麻烦 的 事情 。 要 怎样 做 才能 提高 效率 呢 ? 

有 方法 能 够 搭建 持续 、 自 动 地 向 验证 环境 、staging 环境 以 及 正式 环 
境 进行 发 布 ， 并 一 直 保持 正常 运行 的 环境 ， 本 书 的 第 6 章 中 将 进行 这 方 
面 的 讲解 。 





























了 > 













































































2.3.3 问题 3 : 用 别名 目录 管理 分 支 


这 个 项 目 虽 然 使 用 了 版 本 管理 系统 ， 但 不 能 说 对 其 进行 了 有 效 的 利 
用 。 以 前 连 版 本 管理 系统 都 不 使 用 的 开发 现场 随处 可 见 ， 现 在 使 用 版 本 
管理 系统 的 开发 现场 比较 多 了 。 但 是 如 同 这 个 项 目 一 样 ， 版 本 管理 系统 
没有 得 到 充分 利用 的 情况 却 意外 地 多 。 
使 用 版 本 管理 系统 是 为 了 管理 什么 时 候 、 谁 、 做 了 怎样 的 修改 ( 提 
交 记 录 的 管理 )， 以 及 能 恢复 到 过 去 某 个 时 间 点 的 状态 ( 分支、 标签 的 
管理 )。 这 个 项 目 中 没有 很 好 地 使 用 版 本 管理 系统 的 重要 功能 一 一 分 文 
和 标签 ， 所 以 无 法 从 新 功能 开发 的 版 本 顺利 地 切换 到 有 故障 报告 的 已 经 










































































中 这 里 的 staging 环境 是 指 介 于 开发 环境 和 正式 环境 之 间 的 测试 环境 ， 即 正式 环境 
发 布 前 用 于 验证 的 环境 。 本 书 中 将 staging 环境 用 于 再 现 和 验证 在 正式 环境 中 发 
生 的 故障 。 根 据 环境 的 体系 不 同 ， 也 有 和 正式 环境 保持 完全 一 致 ， 仅 在 发 布 前 用 
于 动作 确认 的 staging 环境 。 在 这 样 的 情况 下 ， 除 了 staging 环境 之 外 ， 还 会 另行 
准备 测试 环境 。 环 境 搭建 包括 运 维 在 内 是 一 笔 不 小 的 开销 ， 所 以 在 体系 以 及 项 目 
预算 允许 的 范围 内 ， 最 合理 地 构建 环境 是 很 重要 的 。 
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发 布 的 版 本 。 只 能 临时 将 本 地 机 器 上 的 目录 重 命名 。 也 就 是 说 ， 本 来 应 
该 交 由 版 本 管理 系统 负责 的 分 支管 理 ， 现 在 由 人 在 本 地 机 器 上 手动 地 进 
行 了 。 

读 过 前 文 的 读者 想必 都 知道 了 ， 用 给 目录 重 命名 的 方法 修改 完 bug 
后 回 到 新 功能 的 开发 ， 之 后 再 一 次 回 到 bug 修改 ， 在 这 样 反复 地 进行 重 
命名 的 过 程 中 ， 很 容易 出 现 问题 。 

那么 到 底 该 如 何 使 用 版 本 管理 系统 呢 ? 版 本 管理 系统 的 分 文 、 标 签 
这 样 的 功能 如 何 使 用 才 是 有 效果 的 呢 ? 

这 个 问题 还 关系 到 今后 程序 以 怎样 的 周期 、 怎 样 的 方式 进行 发 布 ， 
本 书 将 在 第 3 章 进 行 这 方面 的 讲解 。 

























































































2.3.4 问题 4 : 重新 制作 数据 库 比较 困难 


在 构建 staging 环境 或 正式 环境 时 比较 容易 出 问题 的 是 数据 库 的 处 
理 。 虽然 没 有 对 数据 库 的 修改 进行 管理 的 项 目 比较 常见 ， 但 这 个 项 目 还 
是 使 用 版 本 管理 系统 对 SQL 文件 进行 了 管理 的 。 

这 样 就 会 经 常 出 问题 。 比 如 不 知道 在 什么 环境 中 该 使 用 哪些 SQL， 
从 而 导致 没有 察觉 到 遗漏 了 某 些 SQL。 还 有 在 多 个 人 修改 数据 库 的 情况 
下 ， 不 知道 该 如 何 管理 才能 避免 修改 冲突 。 

那么 这 个 项 目 到 底 会 怎么 样 呢 ? 
首先 ， 版 本 管理 系统 上 ， 有 如 下 的 SQL 被 提交 。 


版 本 管理 系统 上 : 

Rev1 : 

提交 者 : ”ikeike443 

Ee ccm ems ea 

CREATE TABLE User( 

id SERIAL NOT NULL, 
name VARCHAR NOT NULL, 
email VARCHAR NOT NULL 


















































REN2R 本 地 环境 中 遗漏 
提交 者 : hori 
adqd column.sqgl 
ALTER TABLE User ADD COLUMN some flag INTEGER; 
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Rev3: 
提交 者 : ikeike443 
user add address.sql 
ALTER TABLE User ADD COLUMN address VARCHAR; 


Rev4: 
提交 者 : okamura 
tel add.sqgl 
ALTER TABLE User ADD COLUMN tel VARCHAR; 


对 应 上 述 SQL， 本 地 开发 环境 和 正式 环境 的 模式 如 图 2.3 所 示 。 
图 2.3 ”本 地 开发 环境 和 正式 环境 的 模式 














本 地 开发 环境 


email |address 





name |some flag| email |address 


ikeike443 的 本 地 环境 中 遗漏 了 Rev ( Revision ) 2 的 add_column. 
sql， 只 执行 了 create user.sql 和 user add address.sql。 但 因为 没有 注意 
到 这 点 并 继续 执行 了 之 后 的 tel_add.sql， 所 以 就 和 正式 环境 产生 了 差异 。 

上 述 例 子 中 是 用 眼睛 看 出 数据 库 模式 上 的 差异 后 ， 手 工 制作 了 相当 
于 add_column.sql 的 文件 并 执行 的 。 但 结果 还 是 出 现 了 原因 不 明 的 运行 时 
错误 。 于 是 只 好 放弃 ， 转 而 从 正式 环境 复制 所 有 的 数据 重新 构建 环境 。 

这 个 谜 一 般 的 运行 时 错误 的 原因 是 什么 呢 ? 

这 是 因为 本 地 开发 环境 和 正式 环境 中 ALTER 语句 的 执行 顺序 不 同 ， 
造成 了 列 的 定义 顺序 和 最 新 代码 不 匹配 ( 图 2.4 )。 根 据 代码 的 写法 以 及 
对 象 关系 映射 (O/R mapping ) 的 实现 的 不 同 ， 有 时 会 出 问题 ， 有 时 也 
可 能 没有 问题 。 但 关键 问题 在 于 因为 没有 制定 构建 数据 库 的 方法 ， 所 以 
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无 法 构建 出 能 够 保证 正常 运行 的 环境 。 
图 2.4 ， 执行 的 顺序 不 同 





三 


上 顺序 不 同 | 
email [address | some flag| 


| 
| 
| 
1 
1 
1 


| name [some flag| email [address 


| i 


要 怎么 做 才能 解决 这 样 的 问题 呢 ? 
第 3 章 中 将 讲解 用 版 本 管理 系统 管理 SQL 的 方法 以 及 处 理 数 据 库 
变更 管理 的 工具 。 
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2.4 案例 分 析 (第 2 天 ) 


接着 来 看 一 下 项 目 第 2 天 中 发 生 的 事情 。 项 目 会 怎么 样 呢 ? 


2.4.1 问题 5 : 不 运行 系统 就 无 法 察觉 问题 


第 二 天 早上 ， 刚 坐 到 椅子 上 准备 继续 开发 新 功能 时 ， 测 试 人 员 来 到 
了 你 的 座位 前 。 说 是 昨天 提交 的 版 本 有 问题 。 在 提交 的 4 个 bug 中 , 能 
够 确认 其 中 3 个 已 经 得 到 了 修正 ,但 男 外 1 个 还 是 有 问题 。 

并 且 还 有 报告 说 发 生 了 退化 ， 以 前 修正 好 的 bug 因为 这 次 的 修改 又 
再 次 出 现 了 。 可 昨 晚 明明 自己 和 组 员 一 起 努力 把 邮件 中 提 到 的 4 个 bug 
都 修正 并 提交 了 呵 ， 而 且 还 在 各 自 的 环境 中 对 修正 进行 了 确认 呢 。 

不 过 重新 回想 一 下 的 话 ， 确 实 没 有 将 全 员 的 代码 集中 到 一 起 运行 
过 。 因 为 在 测试 人 员 的 环境 中 是 第 一 次 将 所 有 的 修改 合并 到 一 起 运行 
的 ， 所 以 就 出 现 了 上 述 状况 。 









































2.4.2 ”问题 6 : 覆盖 了 其 他 组 员 修 正 的 代码 


下 载 最 新 的 代码 并 运行 ， 发 现 确实 如 测试 人 员 所 说 : 3 个 修正 了 ， 
1 个 没有 修正 ， 并 且 过 去 修正 了 的 bug 又 复活 了 。 你 觉得 实在 是 很 奇怪 ， 
就 看 了 下 代码 库 的 提交 记录 “。 


rev: 245 
































Author: ikeike443 <ikeike443@gmail .com> 
Wates Mon Dec 24°23:59:59 2012 "0900 


4 


Ke 


正 了 发 送 邮件 的 逻辑 





rev: 244 
Author: okamura <hogehoge@gmail .com> 





中 这 里 以 Subversion 为 例 。 
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下 Men Dec 24 215704757 2012 #0900 





修正 了 申请 时 扣 款 处 理 失败 的 问题 








Ee 2243 
Author: ikeike443 <ikeike443@gmail.com> 
Baker Mon Dec 24 19:55:5S5 2012 +0900 


























修正 了 某 些 时 间 点 无 法 进行 申请 处 理 的 pug 

Rev244 和 243 都 修改 了 申请 处 理 相关 的 部 分 ， 觉 得 这 里 有 些 奇怪 ， 
就 查看 了 下 Di 他 "， 才 发 现 你 在 Rev243 中 提交 的 修改 被 Rev244 覆盖 掉 了 。 

你 所 提交 的 修改 如 下 所 示 “。 


























Rev243 和 Rev244 的 Diff ( 在 Rev243 中 增加 的 修改 ) 


Fuser status 3 
application.submit () 

- } else { 

// 考 虑 到 用 户 状态 是 Nul1 的 情况 


if(user.status != null && user.status == oe 


























application.submit () 
} else { 


这 个 修正 被 之 后 的 提交 覆盖 ， 如 下 所 示 。 


平 六 本 站 





Rev243 和 Rev244 的 Diff ( 在 Rev244 中 增加 的 修改 ) 


- ”// 考 虑 到 用 户 状 态 是 Nu11 的 情况 
















































































- if(user.status != null && user.status == 3) { 

- application.submit () 

- } else { 

+ // 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 

+ if(user.status == 3 && user.useCredit == true) { 


+ application.submit (); 


ballang.creditetatus = 1 


四 
了 
十 billing.execute(); 
本 
四 


} else { 





QD 原 指 比较 文件 并 输出 文件 之 间 的 差异 的 程序 。 这 里 指 差异 本 身 。 
@ 这 段 代 码 自身 原本 就 有 如 下 列举 的 这 些 问 题 。 有 必要 从 根本 上 提高 代码 的 质量 。 
@ 使 用 了 魔 数 (magic number ) 
@ 没有 确认 application.submit 的 返回 结果 
没有 处 理 异 常 
@ 代码 的 实现 有 副作用 ( side effect ) 


心 
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在 Rev243 中 特地 加 上 的 userstatus 的 Null 检查 ”, 被 Rev244 覆盖 后 
Null 检查 就 没有 了 。 为 什么 会 发 生 这 样 的 事情 呢 ? 

结果 ， 原 以 为 已 经 修正 的 bug 还 是 有 问题 ， 原 因 是 代码 被 覆盖 而 造 

成 了 退化 ”。 向 覆盖 代码 的 开发 者 询问 事情 的 缘由 ， 对 方 却 只 是 回答 道 : 

“向 代码 库 提交 在 自己 的 本 地 环境 中 修正 的 代码 时 发 生 了 冲突 ( conflict ) ， 

只 是 把 冲突 改 掉 了 。” 
这 时 你 很 想 斥 责 对 方 :"“ 那 是 你 修正 冲突 的 方法 有 问题 !” 但 还 是 控制 
住 了 自己 的 脾气 ， 包 括 那 个 开发 者 的 修正 在 内 ， 你 对 代码 做 了 如 下 修正 。 























Rev245 和 最 新 的 Rev246 的 Diff ( 这 次 的 修正 ) 


- // 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 
























































- if(user.status == 3 && user.useCredit == true) { 
= application.submit (); 


- billing.creditSstatus = 工 7 
- billing.execute(); 


} else { 
// 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 
// 考 虑 到 用 户 状态 是 Nu11 的 情况 
if (user.status != null && 
user.status == 3 && user.useCredit == true) { 




































































application.submit (); 


billing.creditSstatus = 1; 
billing.execute(); 


++++++++++ 1 


} else { 


2.4.3 ”问题 7 : 无 法 自信 地 进行 代码 重 构 


这 么 修改 姑且 合并 ( Merge ) “成 功 了 ,但 因为 让 语句 发 生 了 变化 ， 
所 以 程序 的 动作 也 会 发 生变 化 。 这 时 你 觉得 进行 一 下 代码 重 构 比 较 好 ， 
但 是 却 没 有 信心 能 够 在 确保 不 发 生 退 化 的 情况 下 进行 代码 重 构 。 没 有 办 





























中 “userstatus != null” 这 一 部 分 。 可 见 在 Rev244 中 被 删除 了 。 

@ 由 于 添加 功能 或 者 修改 bug 而 造成 其 他 已 经 实现 了 的 功能 无 法 运行 或 速度 变 慢 的 现 
象 。 这 次 出 现 的 现象 是 ， 因 为 Rev244 的 修正 使 得 Rev243 中 修正 的 代码 被 复原 了 

@ ”对 同一 处 代码 进行 了 不 同 的 修改 ,造成 了 代码 修改 冲突 。 

@ 将 多 件 物品 整合 到 一 起 。 
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- /使 富 卡 的 户 的 情况 下 ， 和 申请 的 同时 进行 各 装 外 昌 


- if(user.status == 3 && user.useCredit == true) { 











= applicat ldons eumie ls 


- billing.creditestatus = 1 
- billing.execute(); 


} else { 
// 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 
// 考 虑 到 用 户 状态 是 Nul1 的 情况 


if (user.status != null && 












































上 由 



































user.status == 3 && user.useCredit == true) { 
applicat lon submie (Os: 


billing.execute(); 


























// 不 使 用 信用 卡 的 用 户 的 情况 下 


} else if(user.status != null && user.status == Da 














application.submit () 
} else { 


至 此 昨天 发 生 的 4 个 bug 应 该 都 修正 好 了 。 为 避免 测试 人 员 再 像 今 
天 早上 那样 不 给 你 好 脸色 看 ， 所 以 重新 对 所 有 的 用 例 进 行 测试 。 没 有 准 
备 自动 测试 环境 ， 只 能 手动 进行 测试 。 测 试 结果 没有 问题 ， 程 序 也 能 
常 运行 ， 所 以 就 把 代码 提交 了 


下 
元 
本 
R 
证 
+ balling ereditStatus =S 1 
所 
加 
二 
可 
让 





2.4.4 问题 8 : 不 知道 bug 的 修正 日 期 ， 也 不 能 追踪 退化 





区 





还 有 一 件 事 情 : 过 去 的 bug 又 出 现 了 。 这 究竟 是 怎么 回 事 呢 ? 向 测 
试 人 员 问 了 下 这 个 bug 原本 是 什么 时 候 发 生 的 ， 具 体 是 :怎样 的 bug， 回 
答 说 是 大 约 半年 前 直接 收 到 客户 的 邮件 后 ， 证 其 他 开发 人 员 修 正 了 的 
bug。 直 到 现在 才 第 一 次 听 说 这 件 事 情 。 过 去 修正 了 的 bug 再 度 发 生 ， 
可 以 说 是 发 生 了 退化 ， 当 然 不 可 能 就 这 样 进行 发 布 。 

没 办 法 ， 只 能 让 测试 人 员 把 过 去 的 邮件 翻 出 来 ， 找 出 和 用 户 交 流 的 
内 容 。 根 据 好 不 容易 才 找 到 的 邮件 日 期 ， 在 版 本 管理 系统 的 代码 库 中 查 
找 对 应 的 提交 版 本 ， 再 和 当时 负责 修改 的 开发 人 员 一 起 来 确认 ， 终 于 找 
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到 了 当时 的 提交 版 本 。 

但 似乎 这 个 提交 在 大 约 3 个 月 之 前 就 被 其 他 的 修正 发 布 覆 盖 掉 了 。 
正式 环境 发 生 退 化 长 达 3 个 月 之 入， 期 间 谁 都 没有 察觉 出 来 ， 这 实在 是 
非常 糟糕 的 情况 。 这 次 能 够 在 客户 提出 之 前 发 现 ， 实 在 是 不 笠 中 的 万 幸 。 

重新 修正 并 提交 。 想 着 这 下 应 该 没 问 题 了 ， 但 还 是 觉得 不 安心 ， 于 
是 再 次 手动 进行 了 测试 ， 确 认 退 化 已 经 被 修正 了 。 

啊 ! 差点 忘 了 ， 昨 天 发 生 的 4 个 bug 的 修正 没关系 吧 。 修 正 了 过 去 
的 退化 ， 却 导致 了 别 的 退化 发 生 ， 这 可 不 是 六 着 玩 的 。 想 到 这 里 ， 再 次 
对 4 个 bug 进行 了 测试 。 这 次 确实 没 问 题 了 ， 于 是 提交 了 代码 ( 图 2.5 )。 


2.5 至今 为 止 的 提交 状况 

































































a a Rev Rev Rev Rev 
个 
6 个 月 前 3 个 月 前 243 244 245 246 New 


局 一 >2 
半年 前 ”被 别 的 提交 | 
Rev243 被 ! 
Rev244 覆盖 @—>x 
请 处 理 1 
bug 











的 bug ”所 覆盖 





的 











[= 















































2.4.5 问题 9 : 没有 灵活 使 用 分 支 和 标签 


在 这 样 那样 的 “斗争 ”中 ， 不 知 不 觉 已 经 是 傍晚 了 。 本 来 应 该 做 的 
新 功能 开发 还 没有 开始 动手 。 总 觉得 每 天 都 在 干 同样 的 事 。 

不 管 怎么 说 总 算 告 一 段落 了 ， 该 回 到 新 功能 的 开发 上 了 。 用 昨天 本 
命名 的 目录 ， 重 新 开始 开发 。 

稍 等 一 下 ， 从 昨天 开始 斗争 了 两 天 的 bug 修正 会 怎么 样 ? 如 果 就 这 
样 在 昨天 的 目录 的 基础 上 进行 新 功能 开发 ， 并 提交 到 版 本 管理 系统 的 代 














wh 
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码 库 中 的 话 , 感觉 还 是 会 发 生 大 范围 的 退化 "“。 真 是 太 险 了 。 你 注意 到 了 
这 点 ， 开 始 将 昨天 的 修正 合并 到 手头 的 新 功能 开发 版 本 中 (图 2.6)。 幸 
运 的 是 合并 操作 可 以 使 用 工具 机 械 地 进行 ， 但 编译 却 出 了 问题 ”。 


图 2.6 ”没有 忘记 对 修改 进行 合并 , 但 .…… 
































正式 环境 oo 


ER 















































向 正式 环境 ' 正 是 因为 其 他 组 员 
发 布 ” ”的 这 两 个 提交 ， 本 
代码 库 (2 周 前 ) ! 生 了 了 









! 全 发 布 的 时 间 点 “故障 发 生 ， 
J 的 时 











' 全 
间 
， 向 代码 库 提 交 ! ! ， ， ， ， 向 代码 库 
全 从 正式 环境 ， ， ， ， ， ! 提 交 
0 复制 代码 ， | 
1 !' RevRevRevRevRev 


1 
二 下 


， X 243 244 245246247 














须 进行 合并 的 提交 
( 这 次 修正 的 部 分 ) 



































1 合并 
从 代码 库 ! 1! 闻 坟 能 开 改 证 耐 册 相交 
下 载 | ;新 功能 开发 方面 的 提交 RevRevRevRevRev 





























一 边 发 愁 一 边 继续 修改 ， 终 于 编译 是 能 通过 了 ， 但 确认 昨天 之 前 的 
程序 动作 是 否 正 常 时 却 遇 到 了 困难 ， 因 为 昨天 的 事情 几乎 已 经 不 记得 
了 。 总 算 编 译 也 通过 了 ， 程 序 也 能 运行 了 ， 觉 得 应 该 没有 问题 ， 于 是 就 
着 手 继续 新 功能 的 开发 了 。 

昌 然 也 觉得 正 是 因为 反复 出 现 这 样 的 事情 才 导 致 了 现在 的 状态 ， 但 











@ “如 果 合 理 使 用 Subversion 或 Git 等 版 本 管理 系统 的 话 就 不 会 发 生 这 样 的 事情 ”， 
你 的 这 一 想法 是 正确 的 。 
@ 聪明 的 读者 可 能 已 经 注意 到 了 ， 因 为 忘记 了 合并 图 2.6 的 “代码 库 ” 部 分 中 的 


“ 别 的 组 员 的 两 个 提交 ”， 所 以 发 生 了 编译 错误 。 没 有 合理 地 对 分 支 进行 管理 ， 就 
会 发 生 这 样 的 事情 。 
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却 不 知道 应 该 怎么 做 。 就 这 样 怀揣 着 说 不 清 的 不 安 ， 继 续 回 到 了 工作 中 。 


2.4.6 ”问题 10 : 在 测试 环境 、 正 式 环境 上 无 法 运行 


夜幕 降临 ， 新 功能 的 编码 工作 终于 步 人 了 正轨 ， 这 时 测试 人 员 发 来 
肖 息 ， 说 刚才 提交 的 版 本 在 staging 环境 的 特定 条 件 下 无 法 正常 运行 。 
没 办 法 ， 只 好 和 测试 人 员 一 起 对 staging 环境 进行 了 确认 。 

的 确 ， 程 序 自身 启动 起 来 了 ， 过 去 bug 的 退化 也 确认 修正 了 ， 但 其 
他 的 功能 却 出 现 了 “Internal Server Error”"。 刚 才 明 明 在 本 地 确认 过 了 ， 
为 什么 还 会 出 现 错误 呢 ? 

于 是 决定 在 本 地 环境 上 确认 同样 的 操作 。 但 由 于 现在 本 地 机 器 上 的 
开发 环境 是 新 功能 开发 用 的 环境 ”, 因此 只 能 再 一 次 重 命名 目录 , 回 到 刚 
才 还 在 使 用 的 修正 bug 用 的 目录 中 进行 确认 。 

在 本 地 机 器 上 确认 动作 ， 没 有 发 现 问题 ， 可 以 正常 运行 。 应 该 是 本 
地 环境 和 staging 环境 有 什么 地 方 不 一 样 吧 。 这 时 突然 想 了 起 来 ， 昨 天 
修正 bug 的 时 候 添加 了 新 的 库 ， 而 staging 环境 上 还 没有 安装 过 新 添加 
的 库 。 

的 确 ， 在 本 地 确认 完 后 ， 忘 记 让 测试 人 员 安 装 库 了 。 用 邮件 将 本 地 
安装 的 库 发 送 给 测试 人 员 进 行 安装 后 ，staging 环境 能 正常 运行 了 。 总 算 
松 了 口气 ， 但 觉得 这 么 下 去 不 是 个 办 法 ， 难 道 没有 更 有 效 的 方法 来 管理 
库 ， 并 且 能 防止 遗漏 吗 ? 
































二 < 






























































































































































2.4.7 ”问题 11 : 发 布 太 复杂 ， 以 至 于 需要 发 布 手册 


总 算 staging 环境 上 的 测试 也 OK 了 ， 准 备 向 正式 环境 进行 发 布 。 由 
于 发 生 了 之 前 遗漏 库 的 问题 ， 负 责 发 布 的 人 员 要 求 你 提供 发 布 手册 。 于 
是 你 就 和 测试 人 员 一 起 制作 了 发 布 手册 ， 并 在 制作 过 程 中 特别 留意 了 以 
下 几 点 。 








GD 网 站 服务 器 内 部 发 生 的 错误 。 
@) 为 了 保险 起 见 进行 确认 时 ， 发 现 该 项 目 中 没有 用 于 验证 的 环境 ， 所 以 只 能 在 本 地 
机 器 上 通过 目录 重 命名 的 方式 来 验证 。 
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e 应 该 下 载 版 本 管理 系统 的 代码 库 中 的 哪个 版 本 
e 应 该 如 何 更 新 DDL、 依 赖 的 库 以 及 配置 文件 


每 次 都 需要 写 这 样 的 手册 。 有 没有 什么 更 高 效 的 做 法 呢 ? 

因为 这 次 的 发 布 中 包括 重大 的 bug 修正 ， 作 为 开发 者 的 你 被 要 求 一 
同 在 场 。 每 次 发 布 都 要 花费 一 天 的 时 间 ， 彻 夜 进行 。 虽然 你 有 些 不 情 
愿 ， 但 也 没有 办 法 。 今 晚 看 来 是 回 不 去 了 。 

在 彻夜 的 发 布 作业 中 问题 频 发 。 正 式 环境 的 数据 库 由 于 经 历 了 至 今 
为 止 的 开发 过 程 ， 已 经 和 测试 环境 以 及 staging 环境 有 了 很 大 的 差异 ， 
只 能 通过 手动 修改 来 处 理 。 配 置 文件 也 是 只 有 正式 环境 的 写法 不 一 样 ， 
不 得 不 一 边 谨慎 地 用 肉眼 核对 ， 一 边 进行 合并 。 

所 依赖 的 库 的 版 本 不 一 样 的 情况 也 有 很 多 。 为 了 证 正式 环境 运行 起 
来 ， 需 要 很 多 额外 的 作业 ， 并 且 这 些 作 业 的 内 容 没 有 被 记录 在 版 本 管理 
系统 中 ， 所 以 怒 怕 下 一 次 发 布 的 时 候 还 是 会 发 生 同 样 的 问题 

就 这 样 ， 死 亡 行军 仍 在 继续 。 
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2.5 ”案例 分 析 ( 第 2 天 ) 中 的 问题 点 





让 我 们 一 起 来 反思 一 下 第 二 天 中 发 生 的 事情 。 


2.5.1 问题 5 : 不 运行 系统 就 无 法 察觉 问题 

这 个 例子 中 到 底 发 生 了 些 什么 呢 ? 

前 一 天 几 个 人 分 头 修正 了 4 个 bug。 但 第 二 天 早上 全 员 的 修正 代码 
合并 到 一 起 测试 时 ，4 个 bug 中 只 有 3 个 被 修正 了 ， 并 且 过 去 的 bug 还 
发 生 了 退化 。 如 果 开 发 人 员 没 有 说 谎 的 话 ， 那 么 就 有 可 能 是 修正 的 内 容 
互相 发 生 了 干扰 。 

在 这 个 例子 中 ， 版 本 管理 系统 使 用 方法 不 正确 是 造成 他 人 的 修改 内 
容 被 覆盖 并 消失 的 主要 原因 。 仔 细 地 跟踪 调查 版 本 管理 系统 中 的 提交 记 
录 ， 就 能 够 彻底 地 和 弄 清原 因 。 

但 这 里 的 问题 是 : 到 发 现 问题 时 ， 已 经 过 去 了 一 天 一 夜 。 等 到 发 现 
过 去 修正 的 bug 的 退化 ， 那 经 过 的 时 间 就 更 长 了 。 

假如 因为 几 个 月 前 的 修正 而 发 生 了 退化 ， 那 么 追查 提交 记录 并 查 明 
原因 大 概 需 要 多 久 的 时 间 呢 ?请 试 着 想象 一 下 。 这 时 你 可 能 连 想 都 不 愿 
意 想 ， 更 别提 去 做 了 。 难 道 就 没有 办 法 早 一 点 发 现 这 个 问题 吗 ? 

每 次 向 版 本 管理 系统 提交 更 新 时 ， 都 对 程序 整体 是 否 能 正常 build、 
已 有 的 功能 是 否 正常 运行 进行 检查 不 就 可 以 了 吗 ? 

这 样 的 想法 称 为 持续 集成 ( CI )。 这 是 将 团队 成 员 的 修改 等 所 有 项 
目 相 关 的 资源 集中 到 一 起 进行 集成 ， 并 经 常 、 持 续 地 确认 build 及 测试 
是 否 通过 的 一 种 实践 。 

CI 相关 的 内 容 将 在 第 $ 章 中 进行 讲解 ， 用 CI 实现 高 效 的 回归 测试 
相关 的 内 容 将 在 第 7 章 中 进行 讲解 。 








































































































图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


2.5 ”案例 分 析 (第 2 天 ) 中 的 问题 点 | 31 








2.5.2 ”问题 6 : 履 盖 了 其 他 组 员 修正 的 代码 


多 人 开发 程序 时 会 发 生 因 修改 的 代码 重症 而 产生 冲突 的 现象 。 发 生 
冲突 的 情况 下 ， 要 在 保证 双方 修改 都 能 正常 运行 的 前 提 下 进行 合并 ， 
但 要 正确 地 进行 合并 是 非常 困难 的 。 并 且 无 法 保证 每 个 团队 成 员 都 能 
进行 合并 ， 偷 偷 地 直接 将 他 人 的 修改 覆盖 而 不 进行 合并 也 完全 有 可 能 不 
被 发 现 。 

Subversion 和 Git 等 比较 新 的 版 本 管理 系统 的 设计 思想 是 : 原则 上 
不 对 文件 加 锁 ， 并 对 多 人 的 修改 进行 合并 处 理 ， 有 冲突 时 会 明示 并 让 冲 
突 发 生 。 

另 一 方面 , 以 前 的 VSS ( Visual Source Safe ) “等 版 本 管理 系统 的 设 
计 思 想 则 是 对 文件 加 锁 来 避免 冲突 的 发 生 。 

如 果 团 队 中 有 工程 师 是 在 使 用 VSS 等 基于 锁 的 版 本 管理 系统 的 开发 
现场 成 长 起 来 的 话 ， 可 能 会 因为 不 习惯 Subversion 和 Git 这 类 基于 合并 
的 管理 系统 的 思维 方式 ， 而 对 于 发 生 冲 突 时 一 定 要 消除 冲突 无 法 理解 。 
也 可 能 是 因为 开发 人 员 觉 得 无 视 冲 突 ， 强 行 覆 羡 原 有 代码 不 会 有 什么 问 
题 ， 结 果 造 成 了 类 似 这 种 现象 的 发 生 。 

关于 使 用 版 本 管理 系统 来 消除 冲突 的 方法 ， 以 及 基于 合并 的 版 本 管 
理 系统 更 为 优秀 的 原因 等 ， 将 在 第 3 章 中 进行 讲解 。 

在 类 似 于 这 次 例子 的 情况 中 ， 如 果 写 好 测试 用 例 并 用 CI 进行 测试 
的 话 ， 应 该 就 能 及 早 发 现 问题 。CI 相关 的 内 容 将 在 第 5 章 进 行 讲解 。 









































































































































2.5.3 问题 7 : 无 法 自信 地 进行 代码 重 构 


几 处 修改 bug 的 代码 因 被 其 他 组 员 的 提交 所 覆盖 而 消失 了 。 通 过 奶 
查 提交 记录 终于 把 问题 摘 清 楚 了 ， 但 怎么 修改 才 是 最 优雅 的 ， 成 了 件 烦 
心 的 事情 。 
在 多 人 进行 的 开发 中 ， 修 改 的 地 方 发 生 冲 突 是 因为 在 同一 处 地 方 基 





























@ 微软 在 2012 年 之 前 提供 支持 的 版 本 管理 系统 。 现 在 提供 的 是 其 后 续 产品 Team 


Foundation Server。 
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于 不 同 的 目的 添加 了 不 同 的 代码 。 这 意味 着 需要 以 某 种 形式 来 重新 考虑 
代码 的 构造 ， 也 就 是 说 需要 进行 重 构 。 
根据 维基 百科 ， 重 构 的 定义 是 这 样 的 。 








重 构 (refactoring ) 是 指 计算 机 编程 中 ， 在 不 影响 输出 结果 的 
前 提 下 对 代码 内 部 的 构造 进行 整理 。 














正如 上 面 所 描述 的 “不 影响 输出 结果 ”， 重 构 必 须 保证 程序 的 对 外 
偷 出 保持 不 变 。 也 就 是 说 需要 定义 出 该 程序 中 什么 是 正确 的 。 
方法 之 一 就 是 准备 好 规格 说 明 等 资料 。 这 个 方法 的 确 可 以 证 明 “ 正 
确 性 ”， 但 每 次 都 要 手动 确认 重 构 后 程序 的 动作 是 否 符合 规格 要 求 ， 实 
在 太 耗 费时 间 了 。 

一 想到 又 费时 又 麻烦 ， 心 理 上 对 于 重 构 的 抵触 情绪 就 愈 发 高 涨 ， 不 
愿意 动手 去 做 。 在 一 些 开发 现场 ,“ 不 要 动 已 经 在 运行 的 程序 ” 像 这 样 
明令 禁止 重 构 的 情况 也 是 存在 的 。 

为 了 消除 这 样 的 抵触 情绪 ， 能 够 自信 地 进行 重 构 ， 测 试 代码 的 编写 
就 显得 尤为 重要 。 如 前 所 述 ， 重 构 是 “在 不 影响 输出 结果 的 前 提 下 对 代 
码 内 部 的 构造 进行 整理 "， 因 此 只 要 编写 的 测试 代码 可 以 保证 输出 结 
不 发 生变 化 就 可 以 了 “。 将 测试 代码 做 成 只 调用 一 个 命令 就 能 执行 的 形 
式 ， 这 样 就 可 以 简单 地 反复 进行 测试 ， 从 而 在 任何 时 间 都 可 以 迅速 地 对 
程序 的 正确 性 进行 确认 。 只 有 有 了 这 样 的 测试 环境 ， 才 能 重新 着 手 重 构 
工作 。 

能 够 为 编写 测试 代码 提供 方便 的 测试 框架 有 很 多 。 测 试 框架 以 及 测 
试 代码 的 写法 将 在 第 5 章 进 行 讲解 。 

SHH 

成 功 编写 测试 代码 后 ， 心 理 上 对 于 重 构 的 抵触 情绪 就 能 大 幅 减少 。 
在 进行 代码 重 构 后 并 提交 到 版 本 管理 系统 的 代码 库 之 前 ， 调 用 一 条 命令 
执行 测试 ， 这 样 就 能 对 重 构 内 容 的 正确 性 进行 确认 。 所 以 即使 重 构 中 发 
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GD 最 好 是 对 对 象 类 中 的 public 方法 ， 即 公开 的 API 编写 单元 测试 。 但 是 由 于 类 的 分 
害 不 合理 、 数 据 库 或 用 户 界面 和 系统 的 耦合 过 于 紧密 等 原因 ， 无 法 编写 单元 测试 
的 情况 也 时 有 发 生 。 在 这 样 的 情况 下 ， 可 以 对 系统 最 外 侧 的 API ( 一 般 情 况 下 是 
用 户 界面 ) 编写 测试 代码 。 相 关内 容 将 在 第 7 章 中 进行 讲解 。 
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生 了 错误 ， 也 能 在 提交 之 前 及 时 发 现 。 

进一步 导入 CI， 让 测试 代码 能 够 一 直 自 动 执 行 。 对 程序 正确 性 进行 
测试 的 机 会 越 多 ， 越 能 够 安心 地 进行 重 构 。 即 使 在 本 地 环境 中 通过 测 
试 ， 和 其 他 开发 人 员 修 改 的 代码 合并 后 仍 有 可 能 测试 失败 。 并 且 开 发 人 
员 毕 竞 也 是 人 ， 所 以 在 提交 之 前 忘记 执行 测试 也 是 有 可 能 的 。 导 入 CI 
的 话 ， 因 为 CI 服务 融会 自动 执行 测试 ， 所 以 就 能 够 及 时 发 现 问题 。CI 
服务 器 可 以 每 天 定时 执行 测试 ， 也 可 以 每 当 向 版 本 管理 系统 的 代码 库 进 
行 提 交 时 执行 测试 ， 根 据 配置 可 以 在 各 种 时 间 点 执行 测试 并 发 现 问题 。 
通过 编写 测试 代码 以 及 导入 CI， 终 于 可 以 自信 地 进行 代码 重 构 了 ， 产 品 
的 品质 也 自然 而 然 地 有 了 提高 。 

相反 ， 既 不 写 测试 代码 ， 也 不 进行 CI， 并 且 也 不 进行 重 构 ， 这 样 持 
续 维护 的 代码 就 会 成 为 巨大 的 负担 ， 直 至 阻碍 事业 的 发 展 。 这 样 的 代码 
在 《修改 代码 的 艺术 六 中 被 定义 为 Legacy code。 

不 编写 测试 代码 导致 产生 大 量 的 legacy code， 因 此 软件 的 品质 完全 
无 法 提高 。 确 认 “ 正 确 性 ”的 手段 只 有 手动 和 用 眼睛 看 ， 在 这 样 的 情况 
下 ,“ 正 确 性 ”的 确认 就 会 白白 浪费 大 量 时 间 ， 执行 回归 测试 ”就 更 不 现 
实 了 。 越 没 时 间 越 不 写 测试 代码 ， 从 而 产生 越 来 越 多 的 legacy code， 这 
样 便 陷 和 信 了 恶性 循环 之 中 。 

这 样 的 恶性 循环 持续 几 年 后 便 会 陷入 绝境 ， 不 要 说 添加 新 功能 
连 bug 修正 都 忙 不 过 来 ,最终 只 能 被 时 代 所 淘汰 。 这 样 的 软件 产品 并 不 
在 少数 。 

关于 重 构 所 必需 的 测试 代码 的 写法 ， 以 及 持续 地 自动 进行 测试 的 CI 
实践 ， 这 些 将 在 第 5 章 中 进行 讲解 。 

















































































































2.5.4 ”问题 8 : 不 知道 bug 的 修正 日 期 ， 也 不 能 追踪 退化 


在 刚才 的 例子 中 ， 发 生 了 以 前 修正 的 bug 再 度 出 现 (发 生 了 退化 ) 
的 情况 。 不 知道 bug 是 什么 时 候 发 生 的 、 是 怎样 的 bug、 在 哪 次 提交 中 














中 《修改 代码 的 艺术 》( 美 ) Michael C. Feathers 著 ， 候 伯 被 译 ， 机 械 工 业 出 版 社 
2014 年 出 版 。 译 者 注 
@ 该 测试 的 目的 是 检查 程序 的 修改 所 带 来 的 影响 。 具 体 请 参考 第 7 章 。 
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被 修正 ， 这 样 的 事情 在 已 经 运营 较 长 时 间 的 系统 中 可 能 是 比较 常见 的 。 
如 果 仅 用 邮件 或 口头 交流 故障 和 bug， 没 有 在 团队 成 员 之 间 共 享 信息 ， 
就 容易 发 生 这 样 的 事情 。 为 此 ， 首 先 使 用 缺陷 管理 系统 将 问题 从 发 生 到 
解决 的 所 有 过 程 记 录 下 来 是 非常 重要 的 。 关 于 缺陷 管理 系统 ， 将 在 第 4 
章 进 行 讲解 。 

然后 ， 通 过 使 版 本 管理 系统 和 缺陷 管理 系统 进行 交互 ， 就 能 关联 代 
码 的 修改 记录 和 问题 票 ， 并 记录 下 来 。 这 样 就 可 以 从 问题 票 追踪 到 代码 
的 修改 记录 ， 找 出 bug 是 何 时 修正 的 、 谁 修正 的 、 如 何 修正 的 这 些 信 
息 。 反 过 来 也 可 以 从 版 本 管理 系统 上 的 修改 记录 追踪 到 描述 问题 的 bug 
票 。 如 此 一 来 ， 就 既 可 以 从 问题 票 妃 踪 代 码 ， 查 看 代码 被 做 了 怎样 的 修 
改 ， 即 过 去 的 问题 票 的 处 理 结果 ， 又 可 以 从 代码 的 提交 记录 追溯 问题 
票 ， 查 看 问题 的 原因 ， 使 双向 追踪 成 为 了 可 能 。 













































































版 本 管理 系统 和 缺陷 管理 系统 高 效 进行 交互 的 方法 将 在 第 4 章 中 进 
行 讲解 。 只 需 稍微 花 一 些 功夫 ， 问 题 的 可 追踪 性 “就 会 有 所 提升 ， 这 是 
非常 有 效 的 实践 。 


并 且 ，CI 和 缺陷 管理 系统 以 及 版 本 管理 系统 这 三 者 之 间 的 交互 也 是 
非常 重要 的 。 这 样 一 来 ， 某 个 问题 是 在 什么 时 候 被 什么 人 怎样 修改 的 ， 
以 及 修改 结果 是 否 通过 了 测试 、 是 否 反映 到 了 staging 环境 、 是 否 发 布 
到 了 正式 环境 等 ， 整 个 过 程 就 都 可 以 进行 追踪 。CI 和 缺陷 管理 系统 以 及 
版 本 管理 系统 的 交互 ， 可 以 毫 不 夸张 地 说 是 现代 系统 开发 中 的 三 种 神 
如 。 特 别 是 在 实行 敏捷 开发 的 情况 下 ， 这 些 是 最 基础 的 实践 项 目 。 关 于 
这 部 分 将 在 第 5 章 中 进行 讲解 。 

更 进一步 ， 如 果 和 部 署 自动 化 工具 相关 联 ， 那 么 到 部 署 、 发 布 为 
止 就 都 可 以 进行 统一 的 管理 。 近 年 来 ， 一 些 最 先进 的 开发 现场 已 经 在 
尝试 自动 化 部 署 。 包 括 自动 化 部 署 在 内 的 管理 相关 的 内 容 将 在 第 6 章 
进行 讲解 。 
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2.5.5 问题 9 : 没有 灵活 使 用 分 支 和 标签 


这 里 举 的 是 修正 结束 后 回 到 新 功能 开发 时 ， 差 点 忘记 合并 的 例子 。 
问题 3 中 已 经 提 到 过 ， 这 是 因为 没有 合理 使 用 版 本 管理 系统 的 分 支 和 标 
签 功能 而 产生 的 问题 。 关 于 使 用 版 本 管理 系统 有 效 地 并 行 开发 多 个 任务 
的 方法 将 在 第 3 章 中 进行 讲解 。 


















































2.5.6 ”问题 10 : 在 测试 环境 、 正 式 环境 上 无 法 运行 





这 应 该 是 开发 现场 常 有 的 事 ， 以 “在 自己 的 本 地 环境 上 能 正常 运行 ” 
为 由 ， 而 无 视 staging 环境 或 正式 环境 中 发 生 的 问题 ， 这 样 的 开发 人 员 有 时 
还 是 会 遇 到 的 。 和 这 样 的 开发 人 员 是 无 法 进行 沟通 的 。 而 将 在 开发 环境 中 运 
行 的 内 容 在 测试 环境 中 运行 起 来 要 费 一 番 功 夫 ， 将 在 staging 环境 中 运行 的 内 
容 在 正式 环境 中 运行 起 来 也 要 费 一 番 功 夫 ， 这 样 的 话题 倒 也 经 常 昕 说 。 

根据 环境 的 不 同 ， 程 序 运 行 的 动作 发 生变 化 的 问题 通常 称 为 “环境 
依赖 问题 "。 由 于 环境 依赖 而 产生 的 问题 究竟 是 怎样 的 呢 ?” 以 下 是 一 些 
常见 的 情况 : 









































e 由 于 数据 库 模式 的 差异 而 产生 的 问题 

e 没有 安装 程序 所 依赖 的 库 而 产生 的 问题 

e httpd 或 memcached 等 各 种 中 间 件 由 于 环境 不 同 而 配置 发 生变 
化 的 问题 





























数据 库 模 式 差异 的 管理 问题 ， 已 经 在 问题 4 中 讨论 过 ， 具 体 将 第 3 
章 中 进行 讲解 。 程 序 依赖 库 的 问题 也 将 在 第 3 但 的 依赖 关系 的 管理 这 一 
小 节 中 进行 讲解 。 

中 间 件 等 配置 的 问题 ， 必 然 会 因为 环境 的 不 同 而 产生 差异 ， 管 理 
起 来 的 确 是 比较 困难 的 。 在 第 3 章 和 第 6 章 中 将 介绍 管理 相关 的 一 些 
小 技巧 。 

为 了 实现 高 效 、 高 品质 的 开发 ， 这 些 问题 不 能 用 “环境 依赖 ”一 语 
带 过 ， 而 应 该 试 着 去 摸索 解决 方案 。 作 为 全 世界 开发 人 员 努 力 的 结 
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现在 已 经 出 现 了 帮助 解决 这 类 问题 的 工具 。 这 部 分 内 容 将 在 第 6 章 中 进 
行 讲 解 。 








2.5.7 ”问题 11 : 发 布 太 复杂 ， 以 至 于 需要 发 布 手册 





这 个 问题 和 问题 10 也 是 相通 的 。 无 论 哪 里 的 现场 ， 向 正式 环境 进 
行 发 布 都 是 件 复 杂 并 且 伴 有 紧张 感 的 事情 。 数 百 行 的 发 布 手册 由 多 人 
认 两 三 遍 ， 即 使 如 此 谨慎 地 进行 发 布 ， 大 多 数 情 况 下 也 都 不 会 很 顺利 。 
经 历 了 各 种 困难 终于 让 程序 运行 了 起 来 ， 如 果 能 不 出 故障 、 持 续 地 运行 
的 话 ， 那 就 是 上 天 保佑 了 。 这 难道 不 是 开发 现场 的 实际 情况 吗 ? 

并 且 在 大 多 数 情况 下 ， 大 家 往往 会 忘记 将 只 对 正式 环境 进行 的 作业 
提交 到 代码 库 ， 或 者 忘记 反映 到 发 布 手册 上 。 如 果 还 不 得 不 去 解决 其 他 
故障 的 话 ， 那 就 更 不 用 说 了 。 再 加 上 还 要 提交 故障 说 明报 告 、 向 发 布 手 
册 添 加 数量 庞大 的 确认 项 目 ， 或 者 确认 这 些 项 目的 人 数 大 大 增加 ， 这 样 
一 来 就 会 使 业务 更 加 复杂 。 

另 一 方面 ， 多 数 热门 的 Web 服务 都 以 惊人 的 势头 一 边 修正 bug 一 边 
开发 着 新 功能 。 例 如 社交 编程 服务 ， 也 就 是 Git 的 托管 服务 一 一 大 名 易 
易 的 GitHub 在 1 天 之 内 要 进行 100 次 以 上 的 发 布 “。 

怎样 才能 做 到 以 这 样 惊人 的 速度 一 个 接 一 个 地 进行 发 布 呢 ? 至 少 可 
以 知道 肯定 不 是 用 发 布 手册 人 工 介 入 进行 的 。 

就 算 GitHub 这 样 惊人 的 发 布 频 率 属于 例外 情况 ， 但 如 果 部 署 和 发 
布 能 够 通过 自动 化 简化 一 些 的 话 ， 不 仅 能 够 减少 作业 中 的 错误 ， 包 括 用 
户 和 开发 人 员 在 内 ， 大 家 都 会 对 此 喜闻乐见 吧 。 

为 了 实现 上 述 内 容 ， 需 要 解决 环境 依赖 的 问题 ， 还 需要 实现 自动 化 
测试 和 自动 化 部 署 。 换 言 之 就 是 持续 地 维持 “随时 都 能 发 布 ”的 状态 是 
非常 重要 的 。 

这 样 的 想法 称 为 持续 交付 (CD )。CD 是 有 一 定 难 度 的 实践 ， 但 一 
且 实 现 ， 团 队 的 敏捷 开发 效率 就 会 有 飞跃 般 的 提升 。 这 部 分 内 容 将 在 第 
6 章 进行 讲解 。 


























































































































D https://github.com/ 
©® Deploying at GitHub (https://github.com/blog/1241-deploying-at-github ) 
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2.6 什么 是 理想 的 项 目 





前 几 节 中 我 们 回顾 了 死亡 行军 项 目的 现状 以 及 从 中 看 出 的 具体 问 
题 。 解 决 这 些 问题 要 正确 执行 团队 开发 的 流程 。 

而 正确 执行 开发 流程 则 需要 正确 理解 所 使 用 的 工具 的 机 制 ， 合 理 掌 
握 工 具 的 使 用 方法 。 当 然 不 是 用 了 工具 就 能 解决 所 有 的 问题 ， 其 他 还 有 
团队 成 员 的 教育 、 思 想 准 备 等 各 种 各 样 的 方法 论 。 但 最 重要 的 还 是 对 工 
具 的 理解 以 及 合理 运用 ， 由 此 也 造成 了 软件 开发 的 速度 和 质量 的 差异 。 

从 第 3 章 开 始 我 们 将 对 这 些 工具 进行 介绍 ， 并 详细 讲解 这 些 工具 的 
使 用 方法 、 为 什么 需要 这 款 工具 以 及 应 该 注意 哪些 地 方 。 

作为 本 章 的 总 结 ， 我 们 来 看 一 下 理想 的 项 目 开 发 流程 (图 2.7 )。 


图 2.7 ”理想 的 开发 流程 示例 
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结合 测试 












































缺陷 管理 

系统 
对 提交 、 测 试 、『 
部 署 的 状况 进行 
总 括 






































图 2.7 看 起 来 有 点 复杂 ,但 其 实 很 简单 ， 也 就 是 说 ， 只 要 根据 本 章 
中 发 生 的 事情 以 及 从 中 反映 出 来 的 问题 逆向 为 之 就 可 以 了 。 
具体 可 以 总 结 为 以 下 几 点 。 
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2.6.1 使 用 缺陷 管理 系统 对 课题 等 进行 统筹 管理 











使 用 缺陷 管理 系统 而 非 邮 件 对 课题 、 要 做 的 任务 、 发 生 的 故障 等 进 
行 统筹 管理 。 其 中 ， 对 优先 度 和 重要 度 进 行 明确 地 管理 ， 以 及 清楚 地 掌 
握 每 一 个 bug 票 的 状态 ， 这 些 是 非常 重要 的 。 

易于 检索 ， 能 很 快 地 找到 想 找 的 信息 ， 能 检索 到 过 去 的 bug 票 以 及 
与 其 相关 的 处 理 结果 ， 这 些 也 是 很 重要 的 。bug 票 的 处 理 结果 是 版 本 管 
理 中 的 提交 记录 、 是 CI 系统 的 测试 结果 ， 需 要 确保 能 够 检索 到 现在 被 
部 署 到 了 哪个 环境 中 。 另 外 ， 不 仅仅 要 向 开发 团队 的 全 体 成 员 ， 还 要 向 
项 目的 所 有 利益 相关 者 “共享 缺陷 管理 系统 中 统筹 管理 的 信息 ， 这 点 也 
是 很 重要 的 。 
















































































2.6.2 ”尽量 使 用 版 本 管理 系统 


首先 要 正确 使 用 版 本 管理 系统 ， 避 免 无 意 中 将 他 人 的 修正 覆盖 。 其 
次 要 合理 地 管理 分 支 ， 明 确 正 式 环境 中 使 用 的 是 哪个 分 文 ， 最 近 修正 
bug 所 用 的 是 哪个 分 支 ， 新 功能 开发 使 用 的 是 哪个 分 支 ， 这 点 很 重要 。 
这 样 就 可 以 并 行 推进 多 个 开发 任务 。 

另外 ,通过 合理 地 管理 标签 ， 将 某 个 时 间 点 发 布 状态 的 截面 保存 下 
来 ， 这 样 无 论 多 久之 前 的 状态 都 能 够 进行 回 演 ， 这 点 是 很 重要 的 。 还 
有 ， 用 版 本 管理 系统 来 统筹 数据 库 的 变更 管理 和 环境 相关 的 配置 文件 的 
管理 等 也 是 很 重要 的 。 



























































2.6.3 准备 可 以 反复 验证 的 Cl 系统 


准备 好 CI 系统， 时常 将 所 有 的 资源 集中 到 1 处 ， 并 通过 build 确 
认 是 否 可 以 正常 合并 ， 以 及 确认 单元 测试 是 否 总 能 通过 ， 这 些 都 是 很 
重要 的 。 这 样 就 能 立即 发 现 提交 遗漏 、 修 正 错 误 等 问题 ， 从 而 提高 软 
件 质量 。 

















中 不 一 定 隶 属于 开发 团队 ， 但 是 会 受到 项 目 结果 影响 的 利害 关系 人 。 
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并 且 还 需要 恰当 地 编写 测试 代码 和 build 脚本 。 这 里 的 “恰当 ”是 
指 无 论 重复 执行 多 少 次 ， 都 不 会 因为 依赖 某 些 状态 而 改变 执行 的 结 
例如 数据 库 状态 、 环 境 变 量 、 中 间 件 的 配置 等 都 适用 于 此 。 将 这 些 内 容 
总 结 在 一 起 写成 脚本 ， 这 样 原本 复杂 的 数据 库 构建 和 环境 构建 就 能 简单 
地 进行 了 ， 执 行 测试 的 难度 也 会 相应 下 降 。 
































2.6.4 ”将 环境 的 影响 控制 在 最 小 限度 ， 并 随时 可 以 发 布 














管理 因 环境 不 同 而 产生 的 差异 的 确 是 比较 困难 的 ， 但 现在 有 了 实用 
的 工具 。 如 前 所 述 ， 合 理 使 用 脚本 和 工具 ， 对 数据 库 的 变更 以 及 各 个 中 
间 件 等 因 环境 而 产生 差异 的 内 容 进 行 版 本 管理 。 这 样 只 要 准备 好 可 以 重 
复 执行 的 环境 构建 、 发 布 以 及 动作 确认 的 测试 等 ， 应 该 就 可 以 随时 发 布 
最 新 的 程序 了 。 




















2.6.5 ”保留 所 有 记录 以 便 日 后 追踪 


之 前 已 经 提 到 了 很 多 次 ， 对 至 今 为 止 所 有 的 操作 进行 管理 、 记 录 ， 
并 做 到 可 追踪 是 非常 重要 的 。 包 括 什么 时 候 什么 人 对 程序 进行 了 怎样 的 
修改 、 原 来 发 生 了 怎样 的 问题 、 是 否 通过 了 测试 、 是 否 进行 了 发 布 等 所 
有 信息 。 
并 且 对 上 述 信息 进行 简洁 、 方 便 的 管理 也 是 很 重要 的 。 如 果 用 纸 或 
Excel 的 工作 短 ， 无 论 负责 管理 的 人 员 多 么 努力 ， 也 无 法 提高 开发 速度 。 
所 有 事情 都 应 该 实现 自动 化 的 简洁 管理 。 
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2.7 本章 总 结 


怎么 样 ? 实现 了 2.6 节 中 列举 的 关键 点 的 项 目 应 该 可 以 称 为 理想 的 
项 目 了 吧 ? 这 和 案例 分 析 中 死亡 行军 的 项 目 有 着 天 壤 之 别 。 可 是 ， 怎 么 
才能 做 出 这 种 理想 的 项 目 呢 ? 

关于 团队 开发 过 程 中 应 该 采取 的 措施 ， 以 及 各 种 必要 的 工具 的 使 用 
方法 ,我 们 将 从 第 3 章 开始 进行 详细 讲解 。 

但 是 请 不 要 忘记 ,熟练 使 用 工具 的 目的 是 实现 项 目 中 提出 的 目标 ， 
也 就 是 使 顾客 的 价值 最 大 化 。 

为 了 迅速 并 且 准 确 地 实现 项 目 中 提出 的 目标 ， 应 尽 可 能 地 把 可 以 
自动 化 的 工作 交 给 工具 进行 ， 不 要 在 与 用 户 价值 无 关 的 作业 和 没有 必 
要 烦恼 的 事情 上 浪费 劳动 力 ， 这 是 非常 重要 的 。 这 样 ， 项 目的 开发 人 
员 才 能 将 注意 力 集中 在 本 来 应 该 关注 的 地 方 ， 例 如 项 目的 目标 是 否 能 
够 达成 、 现 在 所 做 的 是 否 偏离 正确 作法 等 ， 并 最 终 交 出 完美 的 答卷 ， 
这 才 是 重要 的 。 

接 下 来 ， 就 让 我 们 来 学 习 全 世界 工程 师 们 费 尽 心机 所 开发 出 来 的 实 
践 方法 和 工具 吧 。 
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营 理 





3.1 版 本 管理 系统 


3.1.1 什么 是 版 本 管理 系统 








合理 、 有 效 地 利用 版 本 管理 系统 是 顺利 进行 团队 开发 必 不 可 少 的 、 
最 基础 的 工作 。 是 否 正确 理解 了 版 本 管理 系统 的 概念 及 其 意义 将 直接 左 



































右 团队 所 发 布 的 产品 的 质量 中 最 基本 的 部 分 。 




















究竟 什么 是 版 本 管理 系统 ”版 本 管理 系统 是 将 什么 时 候 、 谁 、 对 
文件 做 了 怎样 的 修改 这 样 的 信息 以 版 本 的 形式 保存 并 进行 管理 的 系统 。 
这 里 提 到 的 文件 当然 包括 代码 ， 但 不 是 说 版 本 管理 系统 只 能 管理 代码 








的 版 本 。 


新 建 表 或 导入 数据 用 的 SQL 文件 、 构 筑 中 间 件 用 的 配置 文件 ， 甚 






































是 应 用 程序 的 说 明 手 册 等 ， 只 要 是 文件 ， 都 可 以 用 版 本 管理 系统 进行 











管理 。 

















下 面 我 们 来 看 一 下 使 用 版 本 管理 系统 所 人 带 来 的 便利 之 处 。 




















3.1.2 ”为 什么 使 用 版 本 管理 系统 能 带 来 便利 


里 系统 的 优点 如 下 所 示 。 














使 用 版 本 管 


ea 











能 够 保留 修改 内 容 这 一 最 基本 的 记录 

能 够 方便 地 查看 版 本 之 间 的 差异 

能 够 防止 错误 地 覆盖 别人 修改 的 代码 

能 够 还 原 到 任意 时 间 点 的 状态 

能 够 生成 多 个 派生 ( 分 支 和 标签 )， 保 留 当 时 项 目 状态 的 截面 
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e@…… 能 够 保留 修改 内 容 这 一 最 基本 的 记录 


什么 时 候 、 谁 、 对 文件 做 了 怎样 的 修改 这 些 信 息 ， 虽 说 是 最 基本 
的 ,但 将 其 作为 记录 保留 下 来 也 是 非常 重要 的 。 在 发 生 问 题 时 ， 追 踪 记 
录 (提交 ) 能 够 帮助 查 明 问题 的 原因 。 
虽然 写 在 纸 上 或 者 使 用 Excel 表格 来 人 工 进 行 管理 也 能 达到 同样 的 
效果 ,但 这 样 团队 需要 的 人 数 就 会 增加 。 随 着 处 理 的 文件 种 类 的 增加 ， 
很 快 这 个 方法 就 会 变 得 不 那么 现实 了 。 

最 近 使 用 上 述 管理 方法 的 项 目 已 经 越 来 越 少见 了 ， 但 是 在 一 些 工 程 
师 较 少 的 网 站 制作 现场 等 ， 还 是 会 有 一 些 人 工 管理 的 地 方 。 如 果 你 正好 
在 这 样 的 现场 ， 就 算 只 是 为 了 简化 记录 操作 ， 也 可 以 考虑 试 着 使 用 版 本 
管理 系统 。 


e@…… 能 够 方便 地 查看 版 本 之 间 的 差异 


使 用 svn diff 或 git diff 这 样 的 命令 就 能 方便 地 确认 各 个 版 
本 之 间 的 差异 ”。 可 以 输入 命令 ， 从 命令 行进 行 确认 。 还 可 以 通过 
TortoiseSVN”、TortoiseGit”、SourceTree 这 样 的 GUI ( Graphical User 
Interface ) 工具 进行 可 视 化 确认 。 除 此 之 外 ， 还 可 以 使 用 Trac 或 GitHub 
这 样 的 基于 Web 的 代码 库 浏 览 絮 进行 确认 。 

能 够 简单 地 确认 版 本 间 的 差异 是 版 本 管理 系统 的 优秀 特征 之 一 。 




























































































@…… 能 够 防止 错误 地 覆盖 他 人 修改 的 代码 


说 起 版 本 管理 系统 和 简单 的 表格 管理 的 区 别 ， 首 先 想到 的 就 是 该 功 
能 。 版 本 管理 系统 将 文件 的 修改 记录 作为 数据 库 进行 管理 ， 所 以 能 够 防 
止 多 人 在 同一 时 间 修 改 同一 文件 的 同一 处 。 





中 请 注意 能 够 简单 地 确认 差异 这 一 点 原则 上 仅 适 用 于 文本 文件 ， 图 片 这 样 的 二 进 制 
文件 则 无 法 简单 地 确认 差异 。 虽 然 从 技术 上 来 说 是 能 够 找 出 二 进 制 文件 的 差异 
的 ， 但 是 这 样 的 差异 不 是 人 类 能 够 理解 的 ， 只 是 二 进 制 数据 之 间 的 差异 。 
http://tortoisesvn.net/ 

https://code.google.com/p/tortoisegit/ 
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http://www.sourcetreeapp.com/ 
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第 2 章 列 举 了 错误 地 把 他 人 的 修改 覆盖 的 例子 ， 如 果 合 理 地 使 用 版 
本 管理 系统 ， 就 不 会 发 生 这 样 的 事情 。 
由 多 人 修改 而 造成 的 冲突 也 称 为 conflict 或 collision” 为 了 解决 冲突 
的 问题 ， 版 本 管理 系统 大 致 提供 了 两 类 机 制 ， 分 别 是 “ 锁 - 修改 - 解锁 
模式 ”( 以 下 称 为 锁 模 式 ) 和 “复制 - 修改 - 合并 模式 ”( 以 下 称 为 合并 
模式 )。 

锁 模 式 的 做 法 是 : 在 某 人 编辑 文件 期 间 ， 将 文件 锁 住 ， 不 允许 其 他 
人 对 此 文件 进行 编辑 。 过 去 的 商用 版 本 管理 系统 主要 采用 这 种 方式 。 这 
种 方式 的 特点 是 简单 ， 对 任何 人 来 说 都 是 易于 理解 、 易 于 操作 。 但 是 缺 
点 在 于 无 法 多 人 同时 进行 并 行 开 发 ， 难 以 提高 开发 速度 。 

合并 模式 不 会 对 文件 加 锁 。 开 发 者 下 载 代码 的 备份 进行 编辑 ， 然 
后 再 提交 到 代码 库 。 人 要 先 对 
差异 进行 合并 ， 然 后 再 提交 。 近 几 年 的 版 本 管理 系统 基本 上 都 采用 这 
种 方式 。 

CVS ( Concurrent Versions System )、Subversion 、Git 这 些 有 名 的 版 
本 管理 系统 都 属于 合并 模式 。 ee 多 人 可 
以 同时 获取 最 新 的 代码 而 不 必 等 待 他 人 的 作业 ， 能 够 并 行 地 推进 开发 。 
A 二 Di 抽 于 II 

人 多 

无 论 是 锁 模式 还 是 合并 模式 ， 合 理 使 用 版 本 管理 系统 都 能 够 防止 无 

意识 地 覆盖 他 人 修改 的 代码 。 


专栏 ” 锁 模式 和 合并 模式 
如 上 所 述 ， 版 本 管理 系统 解决 冲突 的 方式 大 致 可 分 为 两 种 ， 即 
锁 模式 和 合并 模式 。 
VSS ( Visual Source Safe ) 和 Peroforce、PVCS” 这 样 的 专 有 商 
用 版 本 管理 系统 多 采用 锁 模 式 ”。CVS、Subversion、Git、mercurial 
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该 词 多 用 来 指 网 络 数据 的 冲突 ， 所 以 用 来 指 代码 修改 的 冲突 可 能 并 不 是 那么 的 合 
适 ， 但 也 有 不 少 开 发 现场 是 这 么 称呼 的 。 

专 有 软件 (proprietary software )， 和 它 相 对 的 是 自由 软件 。 译 者 注 

这 些 产 品 现在 也 已 经 具备 了 包括 合并 模式 在 内 的 各 种 先进 的 功能 。 
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等 OSS ( Open Source Software， 开 源 软件 ) 的 版 本 管理 系统 多 采 
合并 模式 。 
两 种 方法 都 有 各 自 的 长 处 和 短处 。 近 年 来 使 用 Subversion 和 
Git 的 开发 现场 较 多 ， 合 并 模式 也 逐渐 成 为 主流 。 但 在 大 约 10 年 之 
前 ， 锁 模式 的 商用 版 本 管理 系统 一 直 都 占据 着 主流 位 置 。 
当时 开源 软件 还 没有 像 今天 这 样 被 大 量 用 于 开发 现场 ， 因 此 比 
较 多 的 是 采用 商用 的 版 本 管理 系统 。 一 些 由 那个 时 代 的 工程 师 主 
管 的 开发 现场 ， 至 今 好 像 依然 在 使 用 VSS 这 样 的 锁 模式 的 版 本 管理 
系统 。 
有 的 开发 现场 虽然 使 用 了 Subversion 或 Git， 但 思维 方式 还 是 
基于 锁 模 式 ， 因 此 还 是 无 法 合理 运用 版 本 管理 系统 。 
锁 模式 的 情况 下 ， 在 某 人 编辑 文件 期 间 ， 文 件 将 被 锁 住 ， 所 以 
理论 上 不 会 发 生 冲 突 。 但 另 一 方面 ， 多 人 同时 并 行 编辑 同一 文件 原 
则 上 也 变 得 不 可 能 ( 图 3.a )， 这 样 就 大 大 影响 了 开发 速度 。 如 果 
人 将 文件 锁 住 后 去 休假 了 ， 那 么 开发 就 无 法 进行 下 去 了 "。 





































































































































































































































































































































































































































































































图 3.a ” 锁 模 式 下 无 法 同时 并 行 地 进行 编辑 


























中 央 代 码 库 中 代码 库 
本 提交 8 
无 法 加 锁 
所 解除 锁 
太郎 花子 太郎 花子 

















在 太郎 锁 住 文件 A 进行 编辑 期 间 ， ”在 太郎 完成 编辑 并 解锁 后 ， 花 了 
花子 无 法 再 对 文件 A 加 锁 。 在 太郎 “才能 将 文件 A 签 出 。 也 就 是 说 
完成 编辑 并 解锁 之 前 ， 花 子 只 能 等 待 ”多 个 人 不 能 同时 编辑 同一 个 文件 
















































































与 之 相对 ， 合 并 模式 不 需要 对 文件 加 锁 ， 所 以 同一 文件 可 以 同 





QD 实际 上 版 本 管理 系统 一 般 都 有 强制 解除 锁 的 功能 ， 但 这 需要 管理 员 权 限 ， 操 作 起 
来 也 比较 麻烦 。 
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时 由 多 人 并 行 地 进行 开发 ( 图 3.b )。 提 交 时 会 提醒 你 确认 差异 并 进 
行 合 并 ， 与 他 人 编辑 的 地 方 发 生 重合 时 也 会 检测 出 冲突 ( 图 3.c )。 



































图 3.b ”合并 模式 下 能 够 同时 并 行 地 进行 编辑 








中 央 代码 库 




















太郎 花子 

因为 没有 对 文件 加 锁 ， 所 以 太郎 先进 行 了 提交 ， 所 以 花子 的 提 

太郎 和 花子 两 人 可 以 同时 签 交 不 是 最 新 的 ， 不 能 直接 提交 。 这 

出 文件 A 时 会 提醒 花子 合并 太郎 编辑 的 内 容 
使 文件 成 为 最 新 状态 









































3.c ”通过 更 新 ( Update ) 来 统一 本 地 机 器 上 的 环境 

















中 央 代 码 库 中 央 代码 库 
< 








更 新 并 合并 
太郎 编辑 的 内 容 





花子 编辑 的 内 容 


C= 





花子 医 子 
花子 将 先行 提交 的 太郎 编辑 的 太郎 通过 更 新 花子 提交 的 内 容 
内 容 合并 到 本 地 后 重新 提交 将 其 反映 到 本 地 环境 。 这 样 太郎 
和 花子 的 文件 A 的 内 容 就 统一 了 



























































锁 模式 的 情况 下 ， 文 件 在 被 编辑 期 间 是 无 法 签 出 ( check out ) 
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的 ， 所 以 不 会 发 生 冲 突 。 合 并 模式 下 任何 时 候 都 可 以 签 出 文件 ， 但 
随 之 而 来 的 是 ， 在 你 签 出 文件 后 到 提交 前 这 段 时 间 ， 如 果 有 人 进行 
了 提交 ， 那 么 你 就 需要 将 这 部 分 修改 合并 到 本 地 代码 后 再 进行 提交 。 
这 时 ， 如 果 文 件 编辑 的 地 方 重合 的 话 ， 版 本 管理 系统 会 检测 至 
冲突 ， 并 显示 请 手动 修改 冲突 这 样 的 错误 消息 。 这 是 合并 模式 中 版 
本 管理 系统 的 正常 动作 ， 但 习惯 了 锁 模 式 的 人 会 对 此 感到 非常 奇怪 。 
因此 ， 一 些 维护 旧 的 开发 环境 的 团队 有 时 会 根据 锁 模 式 和 合并 
模式 的 这 些 差 异 ， 固 执 地 认为 Subversion 和 Git 无 法 锁 住 文件 ， 从 
而 造成 冲突 频 发 ， 无 法 有 效 地 管理 代码 。 这 样 的 现象 在 一 些 习惯 了 
锁 模式 的 开发 现场 尤为 显著 。 
实则 恰恰 相反 ， 锁 模式 的 版 本 管理 系统 由 于 效率 较 低 ， 无 法 合 
理 地 进行 版 本 管理 的 情况 较 多 。 
锁 模式 的 版 本 管理 系统 在 文件 加 锁 的 情况 下 拒绝 其 他 人 员 对 此 
文件 进行 编辑 ， 这 样 的 确 不 会 造成 冲突 。 但 实际 开发 中 往往 不 允许 
#“ 慢 条 斯 理 " ， 于 是 开发 人 员 就 会 无 视 文 件 被 锁 住 ， 独 自在 本 地 
进行 开发 ， 等 待 锁 解除 后 再 手动 合并 并 提交 。 
各 个 版 本 管理 系统 可 能 有 所 差异 ， 但 多 数 采用 锁 模 式 的 产品 都 
没有 自动 检查 差异 并 进行 合并 或 者 检测 冲突 等 功能 ， 即 使 有 也 非常 
弱 ， 因 此 容易 发 生 手动 合并 时 不 小 心 将 他 人 的 修改 覆盖 的 情况 。 并 
加 锁 也 不 能 说 是 绝对 的 ， 也 有 将 锁 强 制 解 除 并 履 盖 提 交 的 功能 。 
举 一 个 笔者 亲眼 所 见 的 例子 : 一 位 习惯 了 锁 模 式 的 开发 人 员 在 
更 用 Subversion 这 样 的 系统 时 ， 因 为 讨厌 发 生 冲 突 ， 所 以 没有 使 用 
svn update", 而 是 每 次 都 将 代码 下 载 到 开发 目录 以 外 的 目录 中 , 再 复 
上 自己 编辑 过 的 代码 替换 原 有 代码 后 进行 提交 。 这 种 做 法 真是 令 人 
吃惊 又 哭笑不得 。 
这 样 的 做 法 的 确 不 会 发 生 冲 突 ， 但 随 之 而 来 的 是 将 频繁 发 生 他 
人 的 修改 被 覆盖 的 事情 。 实 际 上 那个 开发 现场 发 生 的 bug 和 退化 实 
太 多 ， 让 人 觉得 项 目 已 经 处 于 骨 溃 的 边缘 。 而 且 笔 者 还 记得 当时 
还 被 视 为 现场 比较 有 经 验 的 开发 人 员 ， 所 以 事态 就 更 为 复杂 了 。 
如 果 大 家 的 工作 单位 现在 还 在 使 用 锁 模 式 的 版 本 管理 系统 ， 或 
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从 代码 库 中 取得 最 新 的 代码 合并 到 本 地 的 命令 。Git 的 情况 下 是 git pull 
origin master, 
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者 像 上 面 那样 虽然 使 用 了 合并 模式 的 系统 但 使 用 方法 有 误 的 话 ， 那 












































么 您 可 以 先 和 周围 的 同事 聊 一 下 本 专栏 的 话题 ， 并 试 着 劝说 他 们 改 
























































但 是 也 有 例外 ， 例 如 在 管理 图 像 这 种 二 i 














制 文件 的 情况 下 ， 因 









































为 它 和 代码 这 样 的 文本 文件 完全 不 同 ， 无 法 i 


























行 合 并 ， 所 以 用 加 锁 






































的 方法 效率 往往 会 高 一 些 。 此 外 ， 在 制作 用 于 重要 发 布 的 包 时 ， 如 






































果 作 业 时 间 长 达 数 小 时 ， 有 时 就 会 特意 加 锁 以 保证 这 段 时 间 内 绝对 

















没有 其 他 人 员 的 修正 加 进来 。 虽 然 近 年 来 合并 模式 已 经 成 为 主流 ， 






































但 大 多 数 的 版 本 管理 系统 对 于 锁 模式 也 是 支持 

































































系统 的 差异 并 合理 使 用 ， 这 才 是 最 重要 的 。 




















的 。 
使 用 版 本 管理 系统 时 ， 理 解锁 模式 和 合并 模式 这 两 种 版 本 管理 








@…… 能 够 还 原 到 任意 时 间 点 的 状态 


因为 保存 着 过 去 的 修改 记录 ， 所 以 在 发 生 任何 问题 的 情况 下 ， 例 如 
在 发 生 退 化 时 或 者 新 添加 的 功能 不 再 需要 时 ， 理 所 当然 地 能 够 立即 回 退 





到 过 去 任意 时 间 点 ( 的 版 本 )。 





不 同 的 版 本 管理 系统 对 于 版 本 的 思考 方式 也 有 所 不 同 。 从 历史 上 来 


说 也 大 致 可 分 为 两 类 : 基于 文件 和 基于 变更 集 ( 





changeset )。 


例如 CVS 是 基于 文件 的 版 本 管理 ， 即 对 每 一 个 文件 分 别 进行 版 本 


管理 。 与 之 相对 应 ，Subversion 及 之 后 (包括 G 





it ) 的 主要 的 版 本 管理 系 


统 都 是 基于 变更 集 的 。 变 更 集 将 对 多 个 文件 的 一 次 修改 看 作 是 理论 上 的 
一 个 单位 。 基 于 变更 集 的 版 本 管理 系统 就 是 以 此 单位 来 分 配 版 本 号 的 。 


基于 文件 的 情况 下 ， 如 果 要 取得 过 去 某 个 时 间 点 的 版 本 ， 就 需要 集 





齐 每 一 个 文件 所 对 应 的 正确 的 版 本 ,例如 文件 A 是 1.1 版 、 文 件 B 是 
1.9 版 、 文 件 C 是 2.3 版 。 与 之 相对 应 ， 基 于 变更 集 的 情况 下 ， 因 为 是 
将 修改 合并 后 进行 管理 的 ， 所 以 要 取得 过 去 某 个 时 间 点 的 版 本 时 ， 只 需 














要 知道 其 版 本 号 就 能 够 完整 地 获取 整个 项 目 。 





如 上 所 述 ,不 同 的 版 本 管理 系统 对 于 版 本 管理 的 思考 方式 虽然 有 所 





不 同 ， 但 都 可 以 随时 回 退 到 过 去 的 任意 时 间 点 。 
的 一 个 很 大 的 优势 。 
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这 是 使 用 版 本 管理 系统 











两 种 。 
VSS 

















源 软件 中 CVS 这 档 
那些 太 习 惯 于 


一 专栏 基于 文件 和 基于 变更 集 
版 本 管理 的 思考 方式 从 历史 上 来 看 有 时 


Visual Source Safe 


3.1 版 本 管理 系统 | 49 



































于 变 


集 这 





这 样 历史 悠久 的 商用 产品 ， 以 及 开 


于 文件 和 基 




















f 较 老 的 工 
F 使 用 VSS 和 CVS 而 不 熟悉 Subversion 及 其 以 




















的 工具 的 























管理 ， 所 以 入 



































的 ， 




















也 进行 
所 以 逐个 提交 文 从 
甚至 可 以 说 在 VSS 和 CVS 的 情况 下 ， 将 文 


提交 。 因 


可 能 是 


大 | 





为 他 们 以 看 


于 文件 的 方式 来 实现 的 。 





三 











于 文件 的 方式 来 理解 版 本 








往 会 胡乱 地 把 提交 的 粒度 分 得 很 细 
为 VSS 和 CVS 是 基于 文件 的 方式 来 管理 





将 文件 


















































直观 。 





版 本 管理 。 











而 Subversion 及 
此 如 果 将 文件 一 个 个 





大 | 














多 个 ， 这 样 





其 以 后 的 





























来 ， 变 








正 的 意义 就 完全 丧失 了 








版 本 管 











理 系统 ji 





个 版 本 都 























化 为 能 够 对 变 
自己 的 含义 。 


集 原 本 的 
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和 打包 一 起 提交 从 结果 上 来 看 是 完全 一 村 


版 本 管理 系统 则 以 变更 集 为 单位 进行 
也 分 开 提 交 ， 变 更 集 也 会 被 分 为 
能 够 为 解决 某 个 














的 。 


个 个 地 分 别提 交 更 为 











件 









































问题 而 进行 修 
































集 进 行 管理 的 意义 在 





让 每 











大 














更 集中 一 起 


提交 。 














发 





尺 队 中 











同 








成 员 一 直 使 用 






























































新 认识 版 本 管理 系统 的 使 


理 系统 一 无 

















此 含义 相同 的 修改 就 应 该 


VSS 或 CVS 等 工 
所 知 的 话 ， 可 以 向 他 介绍 














于 同一 个 变 























， 并 且 对 其 
本 专栏 的 内 容 ， 并 


























方法 。 








能 够 生成 多 个 派生 ( 分 支 和 标签 )， 保 留 当时 项 目 状态 的 断面 


版 本 管理 系统 有 分 支管 理 和 标签 管理 的 功能 。 


第 2 章 的 案例 分 析 中 列举 了 无 法 高 效 地 在 新 功能 








F 发 和 已 发 布 版 本 





的 bug 修正 之 间 切 换 的 问题 ， 其 实 只 要 合理 地 进行 分 支管 理 , 就 能 够 解 


决 这 样 的 问题 。 








分 文 ， 例 如 可 以 分 别 建立 新 功能 


通过 使 
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请 参考 2.2 节 。 
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] 分 支管 理 功能 ， 
F 发 分 文 和 已 发 布 版 本 的 分 文 。 





项 目 就 可 以 在 多 个 方向 上 建立 
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各 个 版 本 管理 系统 在 实现 的 细节 上 可 能 有 所 差异 ， 但 通常 都 具备 
对 分 支 进行 合并 的 功能 。 这 个 功能 越 是 完善 ， 就 越 有 勇气 去 挑战 困难 
的 开发 。 

不 同 的 版 本 管理 系统 在 分 支 切换 、 合 并 的 速度 以 及 正确 性 方面 是 有 
差距 的 ， 近 年 来 Git 是 在 分 支管 理 方面 做 得 最 好 的 。 

标签 管理 是 能 够 对 文件 或 者 变更 集 任意 命名 (打上 标签 ) 的 功能 。 
利用 这 个 功能 可 以 对 过 去 任意 时 间 点 的 系统 快照 进行 管理 。 

可 以 像 阿 尔 法 版 、 贝 塔 版 、 发 布 版 这 样 ， 或 者 像 版 本 0.1、0.2 这 样 
根据 每 个 产品 的 外 部 版 本 号 “来 打上 标签 ， 一 般 都 是 在 到 达 某 节点 时 为 
项 目 打上 标签 的 。 不 同 版 本 管理 系统 的 标签 功能 在 细微 的 动作 或 规格 上 
可 能 有 所 差异 ， 但 思考 方式 大 致 是 相同 的 。 



















































































中 这 里 并 不 是 指 版 本 管理 系统 内 部 的 版 本 号 。 
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3.2 版 本 管理 系统 的 发 展 变迁 














接着 我 们 将 按时 间 顺 序 来 介绍 具有 代表 性 的 版 本 管理 系统 。 

版 本 管理 系统 是 高 效 软件 开发 中 必 不 可 少 的 最 基本 的 要 素 。 因 此 在 
软件 开发 的 历史 上 出 现 过 很 多 版 本 管理 系统 的 概念 ， 这 些 概念 也 得 到 了 
实现 。 

这 里 让 我 们 来 简单 回顾 一 下 版 本 管理 系统 的 历史 ， 看 一 下 与 时 俱 进 
的 版 本 管理 系统 的 思考 方式 (图 3.1 )， 同 时 也 了 解 一 下 版 本 管理 系统 是 
如 何 发 展 到 现在 被 认为 是 最 有 效率 的 分 布 式 版 本 管理 系统 的 。 


3.1 ”版 本 管理 系统 的 历史 
































SCM 出 现 以 前 ” ”SCM 的 古代 SCM 的 中 世纪 SCM 的 文艺 复兴 











1982 1990 1992 1994 1995 2000 2005 2010 
对 分 支 的 恶 惧 …… 向 分 布 式 版 本 
2 . 管理 系统 的 时 
[Es 代 发 展 
本 
接受 了 分 支 、 
SCM 复活 了 
) 二 系统 和 
欢迎 来 到 地 狱 … 


vo 


※SCM 是 Source Code Management ( 代码 管理 系统 ) 的 简称 。 
本 图 参考 了 “The version control timeline” by The plasticscm blog 
( http://codicesoftware.blogspot.com/2010/1 1/version-control-timeline.html ), 
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3.2.1 没有 版 本 管理 系统 的 时 代 ( 20 世纪 70 年 代 以 前 ) 





20 世纪 60 年 代 一 20 世纪 70 年 代 可 以 称 为 “版 本 管理 系统 的 史前 
时 代 ”。 那 时 候 笔者 还 没有 出 生 。 那 个 时 代 还 没有 可 以 称 为 版 本 管理 系 
统 的 产品 。 

当时 可 能 是 以 日 期 命名 的 目录 来 管理 ， 或 者 制作 表格 文件 来 管理 。 
有 些 开发 团队 也 有 可 能 在 内 部 秘密 地 开发 类 似 于 版 本 管理 系统 的 产品 并 
独自 使 用 。 现 在 已 经 无 从 考证 了 。 























3.2.2 RCS 的 时 代 ( 20 世纪 80 年 代 ) 


现在 某 些 UNIX 操作 系统 上 仍然 捆绑 安装 的 RCS ( Revision Control 
System ) 是 于 1982 年 发 布 的 。 它 以 管理 本 地 机 器 上 的 文件 为 目的 ， 是 
最 早 的 真正 意义 上 的 版 本 管理 系统 。 

RCS 具备 了 对 文件 之 间 的 差异 进行 管理 这 种 基本 的 版 本 管理 机 制 ， 
但 还 没有 考虑 到 多 人 开发 的 情况 ， 原 因 是 要 将 管理 的 版 本 和 多 个 人 进行 
共享 是 非常 困难 的 “。 因 此 ,这 只 是 一 款 在 本 地 机 器 上 对 文件 进行 管理 的 
产品 。 
























































3.2.3 CVS 的 诞生 ( 20 世纪 90 年 代 ) 











RCS 之 后 也 发 布 过 一 些 版 本 管理 系统 ， 但 都 是 只 能 在 本 地 机 器 上 对 
文件 进行 管理 ， 对 多 人 开发 的 支持 不 够 这 一 功能 上 的 缺陷 一 直 没 有 得 到 
改善 。 

改变 上 述 状况 的 是 1990 年 左右 发 布 的 CVS ( Concurrent Versions 
System )。 通 过 CVS 名 字 中 的 Concurrent ( 并 行 ) 就 能 知道 ， 这 是 一 款 
为 了 支持 多 人 并 行 开发 而 设计 的 系统 。 

和 RCS 不 同 ，CVS 采用 了 客户 端 / 服 务 器 的 架构 ， 通 过 CVS 服务 



































GD 当然 也 并 非 完全 不 可 能 ， 通 过 共享 目录 ， 在 rcs 文件 中 粘贴 符号 链接 ， 还 是 可 以 
实现 共享 的 。 那 时 候 一 般 所 有 的 开发 都 在 一 台 机 器 上 进行 。 
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器 使 多 人 共享 代码 成 为 可 能 。 从 服务 器 签 出 代码 进行 编辑 ， 然 后 再 提交 
到 服务 器 ， 这 种 现在 看 来 理 所 应 当 的 作业 流程 ， 可 以 说 是 由 CVS 最 先 
确立 的 。CVS 还 采用 了 合并 模式 来 解决 冲突 ， 使 得 多 人 并 行 编辑 同一 文 
件 变 得 容易 进行 。 

但 另 一 方面 ， 版 本 管理 仍 采用 基于 文件 的 方式 实现 ， 每 一 个 文件 都 
有 自己 独立 的 版 本 号 。 因 为 没有 变更 集 的 概念 ， 所 以 发 生 bug 时 要 找 出 
相关 的 一 系列 文件 及 其 版 本 号 是 一 件 比 较 困 难 的 事情 。 
虽然 CVS 实现 了 分 支管 理 和 标签 管理 ， 但 创建 分 支 是 重量 级 的 作 
业 。 特 别 是 将 分 支 再 度 合并 回 主干 时 的 作业 异常 困难 ,根据 项 目的 规 
模 ， 有 时 不 得 不 任命 专门 的 人 员 来 进行 此 作业 。 

CVS 是 最 早 考虑 到 使 用 网 络 的 版 本 管理 系统 ， 并 且 属 于 开源 软件 ， 
使 用 是 免费 的 ， 所 以 从 20 世纪 90 年 代 开 始 就 被 广泛 使 用 。 在 一 些 开 发 
现场 ， 至 今 仍然 在 使 用 CVS。 
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3.2.4 VSS.、Perforce 等 商用 工具 的 诞生 ( 20 世 纪 90 年 代 ) 








在 CVS 被 发 布 的 几乎 同一 时 期 ， 各 个 软件 企业 也 发 布 了 多 款 商 
的 工具 。 具 有 代表 性 的 是 PVCS 、ClearCase、VSS 和 Perforce 等 。 

很 多 历史 较 久 的 开发 团队 至 今 还 使 用 着 上 述 版 本 管理 系统 。 它 们 的 
后 继 产 品 如 今 多 是 将 项 目 管理 等 功能 整合 起 来 ， 以 ALM ( Application 
Lifecycle Management ) 工具 的 形式 出 售 。 

这 些 商 用 工具 和 CVS 相同 ， 也 采用 客户 端 / 服务 器 模式 。 各 个 产品 
在 实现 的 细节 上 有 所 差异 ， 但 大 多 都 是 以 锁 模 式 来 消除 冲突 ， 并 基于 文 
件 进行 版 本 管理 。 

当然 ， 这 是 20 世纪 90 年 代 当 时 的 情况 ， 这 些 工 具 的 最 新 版 本 改进 
并 添加 了 各 类 功能 ， 都 有 着 易于 使 用 的 特性 

20 世纪 90 年 代 出 现 的 这 些 商用 工具 各 具 特 色 ， 被 市 场 广泛 接受 ， 
但 它们 都 没 能 解决 分 支管 理 和 合并 困难 的 问题 。 
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3.2.5 ”Subversion 的 诞生 ( 2000 年 以 后 ) 


进入 2000 年 后 ， 作 为 CVS 的 后 继 ，Subversion 诞生 了 。 它 和 CVS 
样 采用 了 客户 端 / 服 务 器 模式 ， 通 过 合并 模式 来 消除 冲突 。 同 时 还 引 
入 了 变更 集 的 概念 ， 使 得 赋予 相关 联 的 文件 相同 的 版 本 号 成 为 可 能 。 据 
此 ，bug 的 调查 也 变 得 容易 不 少 。 

并 且 Subversion 还 可 以 对 CVS 不 支持 的 文件 名 和 目录 名 的 修改 和 
删除 操作 进行 追踪 。 对 项 目的 管理 也 更 为 灵活 ， 这 也 是 Subversion 的 
特色 。 

Subversion 可 以 说 是 现在 最 普及 的 版 本 管理 系统 。 特 别 是 它 的 
GUI 客户 端 工具 TortoiseSVN 非常 完善 ， 被 Windows 操作 系统 的 用 户 
广泛 接受 。 
虽然 分 支 的 创建 已 经 变 得 简单 且 快 速 ， 但 是 将 分 支 合并 回 主干 的 作 
业 依 然 非 常 费劲 。 因 此 多 数 开发 现场 都 尽量 避免 使 用 合并 ， 把 分 支 的 建 
立 探 制 在 最 小 限度 。 

































































3.2.6 分布 式 版 本 管理 系统 的 诞生 ( 2005 年 以 后 ) 


上 面 介绍 的 CVS、Subversion 以 及 各 个 商用 的 工具 都 是 基于 客户 端 
/服务 器 模式 来 实现 的 。 代 码 库 只 存在 于 服务 器 上 ， 各 开发 人 员 从 服务 
器 上 下 载 代码 ， 编 辑 后 再 提交 到 服务 器 。 

2005 年 出 现 的 Git 改变 了 上 述 方式 。 

Git 的 开发 者 是 著名 的 Linux 之 父 Linus Torvalds。Linux 社区 原本 使 
用 的 是 专 有 "的 分 布 式 版 本 管理 系统 ( Distributed Version Control System ， 
DVCS ) BitKeeper”，, 但 后 来 因为 某 些 原因 不 得 不 放弃 使 用 BitKeeper， 于 
是 就 开始 了 Git 的 开发 。 

Git 出 现 之 后 ， 开 源 项 目 业 界 使 用 分 布 式 版 本 管理 系统 的 项 目 逐 渐 









































由 特定 的 软件 生产 商 发 布 的 规格 等 不 公开 的 产品 。 

http://www.bitkeeper.com/ 

放弃 BitKeeper 的 原因 上 比较 复杂 ， 其 中 涉及 了 商业 协议 等 。 有 兴趣 的 读者 可 以 参 
考 http://www.path8.net/tn/archives/6039。 译 者 注 
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增加 ,分布 式 版 本 管理 系统 逐渐 扎根 下 来 。 如 今 已 经 普及 到 了 开源 项 目 
以 外 的 一 般 项 目 中 。 分 布 式 版 本 管理 系统 中 除了 最 有 名 的 Git 之 外 ， 其 
他 还 有 Mercurial”、Bazaar 等 。 

分 布 式 版 本 管理 系统 最 显著 的 特征 就 是 没有 中 央 代码 库 ， 完 全 采用 
peer to peer 的 模式 。 开 发 人 员 并 不 是 从 中 央 代码 库 中 下 载 代码 ， 而 是 将 
代码 库 完整 地 克隆 到 本 地 机 器 上 ， 使 得 本 地 机 器 上 保存 有 完整 的 代码 库 
备份 ”。 据 此 , 不 需要 借助 网 络 就 能 够 完成 所 有 的 操作 , 因此 具有 提交 等 
命令 执行 速度 快 的 特征 。 因 为 向 本 地 代码 库 提交 的 速度 很 快 ， 所 以 可 以 
频繁 地 进行 提交 ， 以 降低 工作 成 果 丢 失 的 风险 。 

分 支 也 是 一 样 ， 由 于 只 需 自 己 本 地 的 代码 库 就 能 建立 分 支 ， 因 此 在 
想 进行 某 种 尝试 时 ， 就 可 以 随意 地 建立 分 支 。 这 和 Subversion 之 前 的 只 

能 在 中 央 服 务 器 上 建立 分 支 的 中 央 集 权 型 版 本 管理 系统 有 很 大 的 区 别 。 

当然 ，Subversion 之 前 的 产品 中 已 经 实现 的 变更 集 的 管理 和 合并 模 
式 的 冲突 消解 等 功能 ，Git 都 继承 了 下 来 。 

总 之 ， 提 交 、 分 支 、 合 并 的 低 开 销 ， 只 要 正确 提交 就 几乎 不 会 丢失 
作业 ， 试 验 性 质 的 分 支 建立 方便 ， 能 够 实现 灵活 的 工作 流程 ， 这 些 都 是 
Git 比较 主要 的 特征 。 分 布 式 版 本 管理 系统 的 出 现 ， 可 以 说 是 版 本 管理 
系统 和 团队 开发 的 重大 进步 。 

但 是 难点 在 于 学 习 成 本 。 由 于 分 布 式 版 本 管理 系统 ( 在 系统 上 ) 没 
有 中 央 代 码 库 的 概念 ， 和 之 前 的 版 本 管理 系统 的 思想 方式 有 着 根本 性 的 
差异 ， 因 此 初次 使 用 的 人 基本 都 会 感到 不 知 所 措 。 

但 分 布 式 版 本 管理 系统 是 值得 花费 这 样 的 成 本 的 。 世 界 上 几乎 所 有 
的 开源 项 目 都 采用 了 分 布 式 版 本 管理 系统 ， 从 这 点 就 能 看 出 。 


































































































3.2.7 ”番外 篇 : GitHub 的 诞生 





虽然 有 些 偏离 版 本 管理 系统 的 历史 ,但 这 里 我 们 还 是 要 提 下 
GitHub。 








D http://mercurial.selenic.com/ 
@ http://bazaar.canonical.com/ 
@@ ”虽说 机 制 上 不 需要 中 央 代码 库 ， 但 实际 使 用 中 往往 还 是 会 设立 中 央 代 码 库 。 
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GitHub 是 2008 年 诞生 的 Git 项 目的 在 线 托管 服务 。“ 社 交 编 程 ” 
个 标语 可 能 更 为 出 名 "。 

GitHub 之 前 也 有 代码 托管 服务 ,如 SourceForge” 和 assembla 等 。 
些 服务 的 特点 是 能 够 方便 地 托管 代码 ， 还 支持 多 人 开发 和 缺陷 管理 ， 
此 主要 在 开源 软件 界 被 广泛 使 用 。 

GitHub 是 上 述 服 务 的 Git 版 ， 和 上 述 托管 服务 相 比 ，GitHub 更 为 流 
行 和 普及 。 

GitHub 流行 起 来 的 原因 有 很 多 ， 其 中 最 主要 的 是 得 益 于 Fork 和 
Pull Request 这 两 个 特色 功能 。 如 果 别 人 的 项 目 中 有 你 感 兴趣 的 地 方 ， 可 
以 方便 地 克隆 该 项 目 (Fork ) 并 添加 修改 ， 再 发 送 补丁 申请 将 自己 的 修 
改 反映 到 原来 的 项 目 中 (Pull Request )。 

之 前 的 中 央 集 权 型 版 本 管理 系统 是 无 法 实现 上 述 功能 的 。 首 先是 无 
法 对 已 有 项 目 进行 克隆 。 另 外 ， 发 送 给 项 目的 补丁 (修改 ) 如 果 不 能 立 
即 反映 到 项 目 中 ， 也 得 不 到 保存 ， 最 终 就 会 丢失 。 

GitHub 的 成 功 之 处 可 以 说 在 于 将 分 布 式 管理 系统 ( Git ) “不 存在 中 
央 代 码 库 ”这 一 特征 所 具有 的 潜能 最 大 限度 地 激发 了 出 来 。 原 本 以 Git 
为 代表 的 分 布 式 版 本 管理 系统 有 着 运行 速度 快 、 建 立 分 支 简单 快捷 、 合 
并 方便 等 特点 ,但 同时 也 存在 API 比较 复杂 ， 不 了 熟悉 的 话 很 难 灵 活 应 
用 这 样 的 问题 。 

GitHub 可 以 说 是 通过 易 用 易 懂 的 UI 和 高 超 的 设计 灵感 将 Git 的 潜 
力 充分 激发 了 出 来 ,一 下 子 改 变 了 开发 人 员 的 世界 。 

如 今 参 加 开源 项 目的 门 坎 已 经 大 大 降低 。 如 果 开 源 代码 中 有 什么 看 
不 惯 的 地 方 ， 或 者 发 现 了 bug， 都 可 以 Fork 并 进行 修改 。 

修改 顺利 的 话 ， 可 以 向 原来 的 项 目 进行 Pull Request， 将 修改 反映 到 
项 目 中 。 这 样 就 对 开源 项 目 做 出 了 自己 的 贡献 ， 不 需要 其 他 任何 杂 七 杂 
八 的 事情 。 

如 此 便捷 的 GitHub， 如 果 只 用 在 开源 软件 界 就 太 浪费 了 。 事 实 上 ， 


洲 


































































































中 到 2014 年 ，GitHub 网 站 上 社交 编程 这 个 标语 已 经 没有 了 。 
@ http://sourceforge.net/ 
@) https:/www.assembla.com/ 
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世界 上 的 很 多 公司 都 已 经 在 使 用 GitHub 开发 自己 的 产品 。 可 以 毫 不 硅 
张 地 说 日 本 国内 主要 的 互联 网 服务 提供 商 几乎 都 在 使 用 GitHub。 

笔者 现在 所 属 的 公司 也 在 使 用 GitHub。 一 旦 了 解 了 GitHub 的 便利 
性 和 分 布 式 版 本 管理 系统 的 自由 性 ， 就 很 难 再 回 到 之 前 的 中 央 集 权 型 版 
本 管理 系统 了 。 听 说 一 些 资深 的 工程 师 ， 换 工作 时 都 会 确认 对 方 企业 是 
否 使 用 GitHub。 

GitHub 的 共享 代码 库 是 免费 的 ， 但 私有 的 代码 库 还 是 收费 的 ， 这 点 
请 注意 。 并 且 GitHub 还 有 供 公司 内 部 局 域 网 使 用 的 产品 GitHub 
Enterprise”。 企 业 在 开发 产品 时 使 用 私有 代码 库 的 花费 “或 者 GitHub 
Enterprise 的 花费 需要 预先 纳入 到 项 目 预算 中 。 但 这 样 的 花费 还 算是 物 
有 所 值 的 。? 





























































































































3.2.8 ”版 本 管理 系统 的 导入 情况 


走马 观 花 地 看 了 一 遍 版 本 管理 系统 的 历史 。 从 没有 版 本 管理 系统 到 
RCS 的 出 现 ，CVS 、Subversion 的 出 现 ， 再 到 分 布 式 版 本 管理 系统 的 
Git 的 出 现 ， 仅 仅 用 了 20 年 的 时 间 。 在 这 期 间 ， 版 本 管理 系统 从 基于 文 
件 到 基于 变更 集 、 从 锁 模 式 到 合并 模式 、 从 中 央 集 权 型 版 本 管理 系统 到 
分 布 式 版 本 管理 系统 ， 有 了 巨大 的 进步 。 这 些 进步 可 以 说 都 是 人 们 为 了 
使 多 人 同时 并 行 开 发 更 容易 ， 以 及 提高 开发 速度 而 努力 的 结 

取得 这 样 的 进步 只 用 了 20 年 的 时 间 ， 可 以 说 是 相当 迅速 了 。 当 时 
























































https://enterprise.github.com/ 

https://github.com/pricing 

根据 代码 库 和 用 户 数 量 的 不 同 ， 有 各 种 价格 的 套餐 。 具 体 请 参考 GitHub 的 网 站 。 
也 有 和 GitHub 功能 几乎 完全 相同 ， 并 且 私 有 代码 库 在 一 定 程度 上 也 可 以 免费 使 
用 的 服务 ， 那 就 是 Bitbucket ( https://bitbucket.org )。Bitbucket 原本 是 Mercurial 这 
款 分 布 式 版 本 管理 系统 的 托管 服务 ， 现 在 也 支持 Git 了 。 在 公司 内 部 导入 GitHub 
之 前 ， 可 以 先 使 用 Bitbucket 的 私有 代码 库 ， 让 开发 人 员 先 体验 一 下 分 布 式 版 
本 管理 系统 和 Pull Request， 之 后 再 正式 地 导入 GitHub。 或 者 就 这 样 继续 使 用 
Bitbucket 也 是 一 个 不 坏 的 选择 。 

@@ 在 某 些 情况 下 ， 可 能 会 由 于 安全 策略 的 问题 而 不 允许 使 用 GitHub 这 样 的 外 部 服 
务 ， 或 者 没有 使 用 GitHub Enterprise 的 预算 。 这 时 可 以 选择 使 用 Gitlab (http:/ 
gitlab.org )、GitBucket ( https://github.com/takezoe/gitbucket ) 等 GitHub 的 克隆 。 


四 鸭 提 日 
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刚刚 开始 工作 的 20 岁 左 右 的 工程 师 ， 如 今 已 40 岁 左右 ， 并 成 为 了 开发 
现场 的 中 坚 力量 。 到 了 40 多 岁 这 个 年 纪 ， 很 多 工程 师 都 已 经 成 为 项 目 
经 理 ， 或 者 对 工具 和 技术 的 选择 拥有 决定 权 。 当 然 也 有 人 依然 在 开发 现 
场 编写 代码 。 






































特别 是 在 日 本 ， 技 术 方面 的 信息 传人 比 起 美国 要 晚 一 些 。20 世纪 











90 年 代 初出 现 的 CVS 好 像 到 90 年 代 后 期 才 开 始 被 广泛 使 用 ，2000 年 
出 现 的 Subversion 到 2004 一 2005 年 才 逐 渐 普 及 。 至 于 2005 年 出 现 的 


Git， 到 20 


10 














E 才 有 一 部 分 先进 的 公司 开始 使 用 。 直 到 2014 年 ， 多 数 互 
联网 公司 才 开始 讨论 采用 Git。 这 些 都 是 事实 。 

















如 今 还 在 使 用 20 世纪 90 年 代 发 布 的 商用 版 本 管理 系统 的 公司 多 数 
是 企业 级 的 系统 集成 商 〈 SIer )。 特 别 是 日 本 企业 ， 它 们 有 着 只 要 系统 尚 
可 使 用 就 不 会 强行 升级 这 样 独特 的 文化 ， 状 况 就 可 想 而 知 了 。 

你 所 在 的 公司 在 使 用 Git 或 者 GitHub 吗 ?” 如 果 是 的 话 那 么 你 是 幸运 
的 。 你 所 在 的 是 非常 理解 技术 的 优秀 的 公司 ， 或 者 是 最 近 成 立 的 创新 公 
司 。 请 珍惜 这 样 的 环境 。 

如 此 幸运 的 人 应 该 不 会 太 多 。 比 如 有 些 开 发 现场 的 项 目 经 理 当 年 在 
一 线 工作 时 只 能 采用 CVS 这 样 基 于 文件 的 版 本 管理 ， 或 者 用 惯 了 VSS 
这 样 基于 锁 的 难以 并 行 开发 的 系统 ， 这 样 的 开发 现场 往往 不 会 使 用 Git 
或 GitHub。 另 外 ， 由 于 企业 文化 保守 ， 至 今 仍 在 使 用 VSS 的 企业 ， 以 
及 只 是 形式 上 导入 了 Subversion， 用 法 和 VSS 的 时 候 基 本 没有 区 别 的 企 
业 也 是 比较 多 见 的 。 

再 重复 一 下 ， 版 本 管理 系统 只 有 短 短 20 年 的 历史 “。 








假如 你 的 上 司 、 你 






































所 在 的 公司 对 于 版 本 管理 的 理解 不 足 ， 还 在 使 用 




















上 昌 的 模式 进行 管理 ， 这 是 对 技术 方面 的 懈 鳃 而 造成 的 结果 。 在 认识 到 这 





一 点 的 基 而 


上 上 ， 请 从 自 











己 开始 努力 ， 来 改变 这 样 的 公司 文化 。 


Q 不 只 是 版 本 管理 系统 ， 本 书 中 出 现 的 工具 和 插件 都 在 这 不 到 20 年 的 时 间 内 有 了 
巨大 的 进步 。 
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3.3 分布 式 版 本 管理 系统 


3.3.1 使 用 分 布 式 版 本 管理 系统 的 5 大 原因 
分 布 式 版 本 管理 系统 的 优点 有 以 




















2014 年 最 先进 的 版 本 管理 系统 
下 S i 


e…… 能 将 代码 库 完整 地 复制 到 本 地 


这 是 和 中 央 集 权 型 版 本 管理 系统 的 主要 差异 。 之 后 列举 的 优点 几乎 
都 是 基于 这 个 特点 的 。 





























@…… 运行 速度 快 


本 地 机 需 上 存放 有 所 有 的 文件 ， 因 此 通信 开销 低 ， 提 交 、 分 文 、 合 
并 等 操作 速度 快 ， 这 是 分 布 式 版 本 管理 系统 的 一 大 优势 。 





























e@…… 临时 作业 的 提交 易于 管理 


和 中 央 集 权 型 版 本 管理 系统 不 同 ， 分 布 式 版 本 管理 系统 可 以 在 不 影 
响 全 体 代码 库 的 情况 下 在 本 地 提交 代码 。 这 样 可 以 方便 地 保存 临时 作 
业 ， 有 助 提高 开发 效率 。 

男 一 个 优点 是 可 以 不 用 考虑 对 整体 的 影响 ,方便 地 进行 实验 性 质 的 
开发 。 


@…… 分 支 、 合 并 简单 方便 


相同 的 内 容 已 经 提 到 过 很 多 次 了 ， 分支 建立 简单 、 快 速 ， 不 仅 能 提 
高 开发 速度 ， 也 不 会 阻碍 你 的 各 种 尝试 ， 这 也 是 一 大 优点 。 









































图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 








60 | 第 3 章 版 本 管理 


@…… 可 以 不 受 地 点 的 限制 进行 协作 开发 


借助 本 地 环境 中 保存 有 全 部 文件 这 一 特性 ， 无 论 在 无 法 连接 互联 网 
的 离线 环境 ， 例 如 在 乘坐 飞机 时 ， 还 是 访问 互联 网 比较 困难 的 偏远 地 
区 ， 都 能 够 顺利 地 进行 开发 。 可 以 说 最 适合 不 限 地 区 和 国家 的 开源 代码 
项 目 了 。 并 且 该 特性 最 近 还 起 到 了 将 软件 开发 企业 从 地 域 限制 中 解放 出 
来 的 作用 ， 以 美国 西海 岸 的 企业 为 中 心 ， 开 发 人 员 的 多 国籍 化 、 多 地 区 
化 正在 推进 之 中 。 






































3.3.2 ”分布 式 版 本 管理 系统 的 缺点 


分 布 式 版 本 管理 系统 作为 当前 最 先进 的 版 本 管理 系统 ， 基 本 上 是 优 
点 占 大 部 分 。 但 缺点 或 者 说 需要 注意 的 地 方 也 并 不 是 没有 。 





e@-…… 系统 中 没有 真正 意义 上 的 最 新 版 本 


因为 系统 中 没有 中 央 数 据 库 ， 所 以 也 不 存在 最 新 版 本 这 一 概念 。 
Subversion 的 话 ， 最 新 版 本 自然 就 是 trunk 上 的 HEAD。 而 分 布 式 版 本 
管理 系统 的 情况 下 ， 如 果 没 有 在 运用 策略 上 确定 中 央 数 据 库 ， 那 么 最 新 
版 本 也 就 无 从 谈 起 。 
































。…… 没有 真正 意义 上 的 版 本 号 


没有 中 央 代 码 库 就 意味 着 不 知道 哪个 是 最 新 版 本 ， 或 者 说 哪个 都 有 
可 能 是 最 新 版 本 。 也 就 是 说 ， 即 使 像 Subversion 那样 连续 地 分 配 版 本 号 
1、2、3 也 没有 任何 意义 。 例 如 版 本 号 231， 至 于 代码 库 A 的 231 版 本 
和 代码 库 A' 的 231 版 本 哪个 是 新 版 本 ， 就 完全 不 知道 了 。 

因此 ， 分 布 式 版 管理 系统 为 每 一 个 变更 集 分 配 了 GUID™ ( Globally 
Unique IDentifier )。 也 就 是 说 ， 并 不 是 管理 版 本 的 新 旧 ， 而 是 管理 变更 
集 的 唯一 性 。 这 样 的 管理 方法 与 合并 的 便利 性 之 间 有 着 密切 的 关联 ,但 



































@ 是 指 全 局 唯一 标识 符 。 原 本 是 不 重复 的 128 位 的 整数 ， 考 虑 到 可 读 性 方面 的 问 
题 ， 分 布 式 版 本 管理 系统 在 使 用 时 采用 了 “26fde9ed06bc4d0f8773cb399e73eb63” 
这 样 的 32 位 十 六 进 制 的 表现 形式 。 
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开发 人 员 之 间 的 对 话 就 比较 麻烦 了 。 这 是 因为 必须 用 隐 星 的 GUID 来 称 
呼 修改 。 比 如 “231 版 本 ”, 就 不 得 不 改称 为 ““26fde9ed06bc4d0f8773cb3 
99e73eb63” 的 修改 ”， 如 果 没 有 习惯 的 话 ， 还 真是 让 人 吃不消 。 


e@…… 工作 流程 的 配置 过 于 灵活 ， 容 易 产生 混乱 


分 布 式 版 本 管理 系统 中 不 存在 中 央 代 码 库 ， 任 何 一 个 代码 库 都 是 等 
价 、 平 行 的 。 系 统 上 可 以 从 任意 一 个 代码 库 向 另 一 个 代码 库 自 由 地 通过 
Push/Pull 来 发 送 修改 补丁 。 这 样 的 形式 能 够 灵活 地 组 建 工作 流程 ， 可 以 
算得 上 是 优点 。 但 如 果 团 队 成 员 没 有 习惯 的 话 ， 反 而 容易 产生 混乱 。 

因此 ， 实 际 运用 中 会 设立 中 央 代码 库 ， 各 开发 人 员 从 中 央 代码 库 殉 
隆 代 码 进行 开发 ， 这 是 比较 常规 的 做 法 。 如 此 一 来 ， 实 际 运用 中 使 用 
GitHub 就 成 了 最 方便 的 选择 ， 这 样 做 的 开发 团队 也 比较 多 见 。 


























@…… 思维 方式 的 习惯 需要 一 定 的 时 间 


如 上 所 述 ， 分布 式 版 本 管理 系统 的 缺点 的 根本 原因 在 于 : 在 使 用 分 
布 式 版 本 管理 系统 时 需要 在 至 今 为 止 的 中 央 集 权 型 版 本 管理 系统 的 基础 
上 进行 范式 转变 ”。 

分 布 式 版 本 管理 系统 和 CVS 、Subversion 、VSS 、Perforce 的 构造 都 
不 类 似 ， 所 以 越 是 习惯 以 前 的 版 本 管理 系统 的 人 ， 在 一 开始 时 就 越 是 容 
易 感 到 困惑 ， 操 作 也 容易 失败 。 这 也 是 导入 分 布 式 版 本 管理 系统 最 大 的 
壁垒 ， 好 在 现在 已 经 出 现 了 较 多 的 和 人 门 书 籍 可 供 参 考 。 


























中 即 思 维 方式 的 根本 转变 。 译 者 注 
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从 这 里 开始 我 们 一 起 来 看 一 下 为 了 顺利 地 推进 团队 开发 ， 我 们 应 该 
用 版 本 管理 系统 具体 管理 些 什么 ， 以 及 如 何 管理 。 


























3.4.1 前 提 





本 节 的 内 容 在 没有 特殊 说 明 的 情况 下 ， 都 是 使 用 Git 和 GitHub 来 进 
行 说 明 的 。 但 这 里 不 会 对 Git 的 安装 方法 和 基本 命令 等 的 使 用 方法 进行 
说 明 。 另 外 ， 虽 然 文 中 会 出 现 一 些 Git 命令 ， 但 也 仅仅 展示 了 这 些 命 令 
的 一 般 用 法 ， 这 点 请 注意 ”。 

Git 的 使 用 门槛 虽然 有 些 高 ， 但 它 非常 灵活 易 用 ， 并 且 几 乎 包罗 了 
所 有 的 需求 和 用 例 。 因 此 当 你 觉得 Git 无 法 实现 某 些 功能 时 ， 可 以 查看 
一 下 相关 网 页 “或 参考 书籍 ， 还 有 man”， 一 定 能 找到 实现 的 方法 。 









































3.4.2 版 本 管理 系统 管理 的 对 象 


nna na lain 胃 是 多 种 多 样 ， 用 一 句 话 来 
概括 就 是 “能 够 管理 的 对 象 都 应 该 用 版 本 管理 系统 进行 管理 ”。 
根据 a ne 从 小 工 到 专家 》 一 书 中 的 解释 ， 其 理由 如 下 。 





























中 ”Git 拥有 非常 灵活 的 命令 体系 ,执行 相同 的 内 容 可 以 有 多 种 做 法 。 
@ 可 以 参考 如 下 资料 。 
' 猴子 都 能 懂 的 GIT 入 门 

http://backlogtool.com/git-guide/cn/ 

* Pro Git 

http://git.oschina.net/progit/ 
@) 在 UNIX/Linux/MacOSX 环境 下 执行 Man git 命令 就 会 显示 Git 的 帮助 手册 。 
由 Andrew Hunt、David Thomas 著 ， 马 维 达 译 ， 电 子 工业 出 版 社 ，2011 年 1 月 。 
译 者 注 
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把 项 目 整体 纳入 到 代码 管理 系统 之 中 ， 这 样 的 做 法 隐 含 着 
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显著 的 优 


点 。 那 就 是 能 够 实现 输出 文件 的 build 作业 自动 化 ， 并 且 能 够 反复 执行 。 


重要 的 是 通过 使 用 版 本 管理 系统 来 管理 所 有 项 目 发 布 所 需要 
的 文件 ， 这 样 就 可 以 实现 build 的 自动 化 。 如 果 为 了 生成 产品 发 布 
所 需要 的 文件 , 每 次 都 要 委托 QA 部 门 “进行 测试 , 或 者 委托 运 维 
部 门 手 动 生成 文件 ， 那 是 不 可 能 实现 优质 快速 的 开发 的 。 


上 述 思 考 方式 称 为 持续 集成 ( Continuous Integration，CI ) 和 持续 交 
付 (Continuous Delivery, CD )。CI 和 CD 在 这 几 年 已 经 成 为 了 热门 词 
汇 ， 其 实在 很 久之 前 已 经 有 一 部 分 开发 团队 对 此 进行 了 实践 。 二 者 相关 
的 内 容 将 分 别 在 第 5 章 和 第 6 章 进 行 说 明 。 
为 了 实现 CI 和 CD 这 样 的 实践 ， 首 要 前 提 就 是 使 用 版 本 管理 系统 


对 所 有 必要 的 信息 进行 适当 的 管理 。 一 般 我 们 所 说 的 应 该 管理 的 信息 主 




















要 包括 以 下 这 些 。 


e 代码 


。 需 求 定义 、 设 计 资料 等 文档 
。 数据库 模式 、 数 据 

。 中 间 件 等 的 配置 文件 

。 库 的 依赖 关系 定义 





上 





版 本 管理 系统 最 基本 的 功能 就 是 对 代码 进行 管理 。 从 版 本 管理 系统 
也 称 为 代码 管理 系统 ( Source Code Management，SCM ) 就 可 以 看 出 ， 
版 本 管理 系统 原本 就 是 为 了 管理 代码 而 设计 的 。 


优秀 的 
所 说 的 代码 
对 测试 代码 

















也 包括 测试 代码 。 测 试 代码 的 写法 将 在 第 5 但 








也 要 进行 版 本 管理 。 





@ 负责 确保 软件 质量 的 部 门 。 





团队 开发 ， 首 先 就 要 从 对 代码 进行 版 本 管理 开始 做 起 。 这 里 
进行 讲 


解 ， 
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e@-…… 需求 资料 、 设 计 资料 等 文档 


对 项 目 相关 的 文档 也 应 该 尽 可 能 地 进行 版 本 管理 。 根 据 所 属 团队 和 
项 目的 不 同 ， 有 些 文档 是 由 销售 人 员 或 者 企划 人 员 撰 写 的 ， 有 些 是 由 程 
序 员 自己 写 的 ， 可 谓 是 多 种 多 样 。 文 档 一 般 反 映 了 项 目的 起 因 ， 即 为 了 
解决 什么 问题 而 开展 的 ， 是 为 了 和 后 继 者 交接 工作 内 容 所 写 的 非常 重要 
的 资料 。 并 且 随 着 项 目的 进行 ， 对 文档 进行 相应 的 修改 也 是 常 有 的 事 
情 ， 因 此 要 尽量 一 同 进行 版 本 管理 。 

如 果 可 能 的 话 ， 请 尽量 用 文本 文件 的 形式 来 管理 这 些 文档 。 现 在 已 
经 有 了 Markdown" 、Textile”、reStructuredText 等 多 种 格式 , 它们 虽然 是 
文本 形式 ,但 在 一 定 程度 上 也 能 制作 出 漂亮 的 文档 。 












































e@…… 数据 库 模 式 、 数 据 


现在 可 以 说 几乎 不 存在 不 使 用 数据 库 的 Web 应 用 程序 。 这 也 意味 着 
没有 理由 不 对 数据 库 模 式 和 数据 “进行 版 本 管理 。 

正如 我 们 在 第 2 章 的 案例 中 所 见 到 的 那样 ， 是 否 能 够 管理 好 数据 库 
模式 及 数据 将 直接 决定 团队 开发 是 否 能 够 顺利 进行 。 本 音 稍 后 会 介绍 成 
功 管理 数据 库 的 机 制 。 






































@……. 配置 文件 


应 用 程序 一 般 都 会 使 用 到 一 些 Web 应 用 程序 框架 以 及 中 间 件 。 这 些 
Web 应 用 程序 的 框架 和 中 间 件 的 配置 文件 也 应 该 进行 版 本 管理 。 

根据 部 署 环境 的 不 同 ， 配 置 文件 中 的 值 也 会 相应 地 改变 ， 因 此 就 
必须 根据 环境 把 配置 文件 分 开 来 。Ruby on Rails 和 Play Framework 等 
最 近 的 Web 应 用 程序 框架 提供 了 针对 不 同 环 境 进行 配置 的 机 制 ， 可 以 
直接 使 用 。 













































































http://daringfireball.net/projects/markdown/ 

http://textile.sitemonks.com/ 

http://docutils.sourceforge.net/rst.html 

这 里 的 数据 不 是 指 随 着 用 户 的 操作 等 而 增加 的 事务 数据 ， 而 是 指 初始 化 设置 这 样 
的 程序 启动 所 必需 的 主 数据 (master data )。 


昌 斩 提 口 
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但 是 ，Apache、PostgreSQL 、memcached 等 应 用 程序 的 配置 文件 大 
都 没有 提供 根据 环境 进行 配置 的 机 制 ， 这 方面 只 能 自己 花 一 些 工 夫 了 。 























@.……. 库 的 依赖 关 系 定 又 

Java 的 话 有 Apache Commons "系列 的 库 ， 脚 本 语言 的 话 有 ImageMagick 2 
和 Mechanize 等 ， 一 般 开发 过 程 中 都 会 用 到 一 些 外 部 的 库 。 这 些 外 部 库 
的 依赖 关系 也 应 该 纳入 到 版 本 管理 系统 中 进行 适当 的 管理 。 























OD http:/commons.apache.org/ 
©® http:/www.imagemagick.org/ 
® http:/mechanize.rubyforge.org/ 
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3.5 使 用 Git 顺利 地 推进 并 行 开发 








这 里 我 们 来 看 一 下 通过 使 用 版 本 管理 系统 ， 在 团队 中 顺利 地 开展 并 
行 开发 的 方法 。 

如 上 所 述 ，Git 提供 了 能 够 使 多 人 并 行 开发 的 合并 模式 ， 因 此 能 
便 地 实现 多 人 同时 编辑 同一 文件 。 但 是 ， 当 一 个 人 不 得 不 并 行 地 进行 多 
个 不 同 的 开发 时 ， 就 会 有 一 些 问 题 。 

第 2 章 的 问题 2 和 问题 9 中 涉及 的 、 在 新 功能 的 开发 过 程 中 需要 
修改 已 发 布 版 本 中 的 bug 的 情况 下 ， 就 可 以 使 用 版 本 管理 系统 的 分 文 
功能 。 
































e…… 什么 是 分 支 


分 支 (branch )， 英 语 的 意思 为 树枝 。 是 一 种 从 主干 分 离 出 来 的 ， 作 
为 和 主 开 发 内 容 不 同 的 开发 内 容 进行 分 别管 理 的 机 制 。 分 支 是 几乎 所 有 
的 版 本 管理 系统 都 具备 的 标准 功能 。 

和 其 他 的 版 本 管理 系统 相 比 ，Git 的 分 支 功能 的 特点 是 速度 快 且 易 
于 使 用 。 














@…… 什么 是 发 布 分 支 ( release branch ) 


以 第 2 章 的 情形 为 例 ， 我 们 来 看 一 下 分 支 的 使 用 方法 。 但 在 此 之 
前 ， 我 们 先 来 谈 一 下 发 布 分 支 的 用 法 。 

发 布 分 支 是 向 正式 环境 进行 发 布 时 实际 使 用 的 分 支 。 有 将 master 用 
作 发 布 分 支 的 ， 也 有 从 master 建立 别 的 分 支 作为 发 布 分 支 的 。 
具体 来 说 就 是 要 根据 各 团队 和 项 目的 实际 情况 选择 合适 的 方法 ， 没 
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有 一 定 正 确 的 答案 。 关 于 使 用 Git 的 工作 流程 的 组 建 方式 ， 我 们 将 稍 后 
介绍 。 本 次 事例 中 暂且 以 master 作为 发 布 分 支 ， 下 面 的 讲解 都 是 以 此 为 
前 提 的 。 

















克隆 和 建立 分 支 
首先 将 ( 所 认为 的 ) 中 央 代码 库 克 隆 到 本 地 机 器 上 。 


$ git clone git@github.com:CoolInc/someniceapp.git 
接着 为 发 布 后 的 新 功能 开发 建立 分 支 。 分 支 的 名 称 就 是 new-cool- 


fonction。 














$ git branch new-cool-function 


分 支 建 立 之 后 进行 checkout 操作 。 这 里 的 checkout 和 以 Subversion 
为 代表 的 中 央 集 权 型 版 本 管理 系统 中 的 checkout 的 意思 是 不 同 的 ， 这 里 
使 用 checkout 命 令 来 进行 分 支 切换 。 
$ git checkout new-cool-function 
这 样 一 来 就 可 以 在 master 以 外 的 分 文 上 进行 新 功能 的 开发 ， 不 会 对 
已 经 发 布 的 代码 产生 任何 影响 。 








e@…… 提交 和 提交 记录 


假设 已 经 修改 了 几 处 代码 ， 现 在 我 们 用 git commit 命 令 来 试 着 
进行 提交 。 


$ git commit -m "实现 了 非常 炫 的 功能 " 
$ git commit -m "修改 了 一 些小 错误 " 
$ git commit -m "想到 了 一 些 需要 改进 的 地 方 ， 于 是 进行 了 修改 " 


上 述 提交 记录 的 问题 在 于 内 容 过 于 抽象 ”， 但 我 们 这 里 暂且 先 继续 
下 去 。 
再 用 git 1og 命 令 来 确认 一 下 提交 记录 。 




















© 


阅读 到 这 里 的 读者 一 定 知道 这 种 写法 的 提交 记录 是 肯定 不 行 的 。 这 里 我 们 是 以 第 
2 章 的 案例 进行 说 明 ， 第 2 章 的 案例 中 也 正 是 因为 没有 正确 地 填写 提交 记录 ， 才 
导致 提交 记录 如 同上 述 提交 记录 一 样 让 人 无 法 理解 。 实 际 操作 中 应 该 将 修改 的 内 
容 写 入 提交 记录 。 关 于 这 部 分 内 容 我 们 在 第 4 章 会 进行 具体 的 讲解 。 另 外 ， 在 提 
交 记 录 中 记 下 相关 联 的 bug 票 号 也 是 非常 重要 的 。 
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$ git 1og --pretty=oneline 
05afd8b298d2439ddf7d5ae720b4967613fbllcb 实现 了 非常 炫 的 功能 
4006971346bocae1596914023981eff4a8b5410c 修改 了 一 些小 错误 
2487df32b6096cd349d8543304a299e41fdb037a 想到 了 一 些 需要 改进 的 地 方 ， 于 是 
进行 了 修改 


还 可 以 用 git branch 命令 来 确认 分 支 的 改变 。 


Sgqit branch 
master 



































* new-cool-function 


至 此 ， 新 建 分 支 的 状态 如 图 3.2 所 示 。 
图 3.2 新 建 的 分 支 











27b0687 master 





New-cool- 
function 


05afd8b 4006971 2487df3 













想到 了 一 些 需 要 
改进 的 地 方 ， 于 
是 进行 了 修改 






修改 了 一 些 
小 错误 





实现 了 非常 
炫 的 功能 



































e…… 分 支 的 切换 


在 第 2 章 的 案例 中 ， 有 报告 称 已 经 发 布 的 正式 环境 中 发 生 了 故障 。 
如 果 按 照 第 2 章 的 死亡 行军 项 目的 做 法 ， 又 是 给 目录 重 命名 又 是 复制 
文件 的 话 ， 那 就 实在 太 麻烦 了 。 其 实用 git checkout 命 令 就 能 简单 
处 理 。 


$ git checkout master 


只 需 执 行 上 述 命令 就 能 切换 回 master 分 支 ， 即 本 次 事例 中 的 发 布 分 
支 。 如 果 不 确定 是 否 已 经 回 到 master 分 支 ， 可 以 通过 git 1og 命 令 确 
认 下 提交 记录 。 


$ git log --pretty=oneline 
27b06870957e44d5b02606af668c9al20Gf4b7e0 最 初 的 发 布 版 本 
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保险 起 见 ， 我 们 再 用 git Pranch 命 令 来 确认 下 。 


sait branck 
* master 
new-cool-function 


确实 已 经 回 到 了 master 分 支 。 这 里 假设 我 们 正 处 于 第 2 章 所 述 的 境 
况 下 ， 让 我 们 试 着 对 故障 进行 处 理 。 不 直接 修改 master， 而 是 新 建 故障 
处 理 用 的 分 支 ， 然 后 再 进行 提交 。Git 的 分 支 建立 非常 快速 且 易 于 合并 ， 
因此 应 该 灵活 应 用 其 分 支 功能 。 


git checkout -b issue345 
re Dramnem 




















A 


* 


issue345 
master 
new-cool-function 


可 以 使 用 git checkout -b XXX 命令 来 建立 分 支 并 同时 进行 
checkout 操作 。 分 支 的 名 字 可 以 任意 取 ， 这 次 假设 已 经 有 了 故障 报告 的 
bug 票 (ticket )， 以 票 号 为 名 字 建 立 分 支 。 缺陷 (ticket ) 管理 系统 
(ITS/BTS ) 的 相关 内 容 将 在 第 4 章 进 行 讲解 。 




















e…… 修正 bug 后 的 提交 





在 issue345 分 支 上 对 bug 进行 了 修正 ， 并 进行 了 3 次 提交 ， 如 下 
所 示 。 


$ git commit -m "邮件 的 pug 修正 
$ git commit -m "申请 时 的 死 锁 问题 的 修正 
$ git commit -m " 删 去 没 用 的 代码 " 


在 issue345 上 提交 了 3 个 修正 后 ,分 支 的 状态 如 图 3.3 所 示 。 
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图 3.3 ”新 建 的 故障 处 理 用 的 分 支 





master 


2487df3】new-cool- 
function 








修改 了 一 些 
小 错误 












实现 了 非常 
炫 的 功能 


























是 进行 了 修改 


ae9884e ad2d9a2 bdabe98j issue345 


请 时 的 
死 锁 问 题 
的 修正 














































@.……. 合并 到 master 


修正 告 一 段落 后 ， 让 我 们 把 修改 的 内 容 合 并 到 master。 只 需 切 换 到 
master 并 执行 以 下 命令 即 可 。 


$ git checkout master 





$ git merge issue345 

Updating e380b5e..8f3b4e5 

Fast forward 
src/main/scala/Application.scala | 1 - 
src/main/scala/MailSender.scala | 13 + 
2 files changed, 13 insertions(+), 1 deletions(-) 


最 终 的 状态 如 图 3.4 所 示 。 
在 完全 不 影响 新 功能 开发 的 基础 上 ， 完 成 了 对 故障 的 处 理 ”。 























中 实际 在 案例 分 析 中 数据 库 的 变更 管理 也 是 非常 环 手 的 一 个 问题 ， 需 要 予以 解决 。 
但 这 里 暂且 不 进行 说 明 ， 数 据 库 变更 管理 的 相关 内 容 将 在 后 面 进行 讲解 。 
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图 3.4 ”合并 到 master 





master 








05afd8b}»(4006971}»(2487df3)] new-coor 


function 





实现 了 非常 
炫 的 功能 






小 错误 





















死 锁 问题 
的 修正 














@… 向 master 进行 Push 


接着 ， 把 本 地 机 器 上 合并 到 master 分 支 中 的 修正 用 git push 命 
令 Push 到 中 央 代 码 库 。 


$ git push origin master:master 


这 样 Push 就 完成 了 。 接 着 让 QA 部 门 进行 验收 测试 ， 用 git 
checkout 命 令 就 能 回 到 原来 的 新 功能 开发 。 
$ git checkout new-cool-function 
之 后 ， 在 new-cool-function 分 支 上 进行 新 功能 添加 的 开发 ， 开 发 完 
成 后 合并 到 master 即 可 “。 


二 














@ 因为 本 次 的 例子 非常 简单 ， 所 以 能 够 轻易 地 合并 ， 但 也 有 发 生 冲突 无 法 合并 的 时 
候 。 在 这 种 情况 下 ， 首 先 要 合理 地 解决 冲突 ， 然 后 再 重新 合并 。 这 和 Subversion 
等 其 他 的 版 本 管理 系统 的 思考 方式 是 一 样 的 。 
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e.…… 分 支 使 用 方法 总 结 


像 这 样 通过 合理 使 用 分 支 功能 ， 并 行 地 进行 多 个 版 本 的 开发 也 变 得 
容易 了 "。 

Subversion 这 样 的 中 央 集 权 型 版 本 管理 系统 无 法 像 Git 这 样 简单 地 
建立 分 支 。Git 的 话 还 可 以 在 本 地 机 器 的 封闭 环境 下 随意 地 建立 分 支 、 
进行 合并 ， 因 此 能 够 以 简单 且 高 速 的 方法 实现 并 行 开发 。 























3.5.2 标签 的 使 用 方法 


@…… 什么 是 标签 

在 刚才 的 例子 中 ， 你 是 否 觉得 如 果 能 把 发 布 时 的 系统 快照 保存 下 来 
会 很 方便 呢 ? 标签 ( tag ) 就 是 用 于 实现 这 个 功能 的 。 实 现 的 细节 上 可 能 
有 所 差异 ， 但 几乎 所 有 的 版 本 管理 系统 都 提供 了 标签 功能 。 











e@…… 新 建 标签 


还 是 刚才 的 例子 ， 首 先 可 以 为 发 布 的 时 间 点 打上 标签 。 下 面 就 以 
“v0.1" 为 标签 名 ,执行 git tag 命 令 。 标 签名 在 内 容 上 要 简洁 易 慌 ， 
一 般 多 以 版 本 号 作为 标签 名 。 
$ git tag -a v0.1 -m "最 早 的 发 布 版 本 " 

这 样 以 后 也 能 找 出 这 个 时 间 点 的 系统 快照 了 。 

第 2 章 的 案例 分 析 中 ， 发 布 之 后 已 经 过 了 一 段 时 间 ， 这 样 的 情况 下 
仍然 可 以 追溯 回去 打上 标签 。 首 先 在 master 分 支 上 用 git 1og 命 令 寻 
找 对 应 的 提交 。 


$ git log --pretty=oneline 
27b06870957e44d5b02606af668c9al20df4b7e0 最 早 的 发 布 版 本 
ae9884e9fle7551026c447556c63db58d4996774 邮件 的 pug 修正 
ad2d9a217af750b2fb0a0636f0a26ef761ba2bfc 申请 时 的 死 锁 问题 的 修正 
bdabe98d3b9102ce33ed7b4c6033ebc9cbb44fe6 删 去 没 用 的 代码 



























































GD 关于 分 支 功能 请 参考 Pro Git 中 文 版 “Git 分 支 ” 一 章 (http://git.oschina.net/progit/3- 
Git- 分支 .html) 或 者 nulab 提供 的 “猴子 都 能 懂 的 Git 入 门 ”( http://backlogtool. 
com/git-guide/cn/ ) 等 ， 上 述 资 料 对 Git 的 分 支 功 能 做 了 浅显 易 懂 的 总 结 。 
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找到 对 应 的 提交 之 后 , 用 git 上 tag 命令 为 那个 提交 打上 标签 。 这 
样 就 OK 了 。 


$ git tag -a v0.1 27b06870957e44d5b02606af668c9al20df4b7e0 








e…… 标签 的 确认 
下 面 来 确认 下 刚才 建立 的 标签 。 


solit tag 
OL 


确认 了 标签 之 后 ， 再 来 确认 下 标签 对 应 的 内 容 是 否 正确 。 


$ git show vO.1 









































tag Vow 
Tagger: ikeike443 <ikeike443@gmail .com> 
下 Thu May 16 于 5732759.20137+0900 


commit 27b06870957e44d5b02606af668c9al20df4b7e0 
Author: ikeike443 <ikeike443@gmail.com> 
四 ae Thu May 9 19:29:49 2013 +0900 


最 早 的 发 布 版 本 



































可 以 用 git show 命 令 来 确认 标签 的 内 容 。 从 结果 来 看 内 容 似乎 是 正 
确 的 。 在 本 地 环境 上 打 好 标签 后 ， 用 git push 命令 Push 到 中 央 代 码 库 。 


Snoush or OR OR 








i 标签 的 取得 


如 果 要 在 其 他 环境 上 取得 刚才 建立 的 标签 ， 应 该 怎么 做 呢 ? 
首先 ， 在 其 他 环境 上 用 git clone 命 令 进 行 克 隆 。 git clone,， 
顾名思义 ， 就 是 克隆 代码 库 的 命令 。 代 码 库 中 包含 的 分 支 、 标 签 都 会 被 
复制 到 本 地 环境 中 。 
s$ git clone git@github.com:CoolInc/someniceapp.git 

克隆 执行 完 后 建立 分 支 ， 并 将 标签 checkout 到 该 分 支 上 "。 


中 这 里 也 可 以 把 标签 名 和 分 支 名 都 设置 成 “v0.1”"， 但 这 里 没有 这 么 做 。 相 关 原 因 请 
参考 专栏 
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$ git checkout -b 0.1 v0.1 





这 样 就 能 在 其 他 环境 上 取得 标签 了 。 如 果 不 想 新 建 分 支 的 话 ， 还 可 











以 用 下 面 的 方法 ”。 


$ git checkout vO.1 











[一 专栏 ”避免 使 用 相同 的 标签 名 和 分 支 名 
本 文 的 例子 中 虽然 避免 使 用 相同 的 分 支 名 和 标签 名 ,但 使 用 相 

同 的 名 称 也 是 可 以 的 。 

$ git checkout -b v0.1 v0.1 

新 建 名 为 “v0.1” 的 分 支 ， 在 其 基础 上 checkout 名 为 “v0.1” 

的 标签 。 但 是 因为 同名 的 缘故 ,“v0.1" 指 的 是 分 支 还 是 标签 就 不 清 

楚 了 。 
这 里 ， 因 为 执行 的 时 候 还 没有 名 为 “v0.1” 的 分 支 ， 所 以 能 够 顺 

利 执行 。 如 果 已 经 存在 名 为 “v0.1” 分 支 ， 则 是 无 法 执行 的 。 例 如 ， 

如 果 之 后 再 新 建 名 为 “test” 的 分 支 ， 并 在 其 上 checkout “v0.1” 

标签 ， 就 会 出 现 以 下 消息 。 


$ git checkout -b test v0O.1 
warning: refname 'v0.1' is ambiguous. 
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fatal: Ambiguous object name: 'v0.1'. 


相反 ， 在 从 master 切换 到 “v0.1” 分 支 时 也 会 出 现 同样 的 问题 。 


$ git checkout vO.1 








warning: refname !V0.1' is ambiguous. 
fatal: Ambiguous object name: 'v0.1'. 


在 这 种 情况 下 ， 需 要 像 下 面 这 样 明确 指出 这 个 是 标签 还 是 分 支 。 


//vV0.1lcheckout 名 为 “v0 .1” 的 标签 
$ git checkout -b test refs/tags/v0.1 











//V0.1lcheckout 名 为 “v0 .1” 的 分 支 
$ git checkout refs/heads/v0.1 


Git 中 ， 标 签 和 分 支 实际 上 分 属于 不 同 的 命名 空间 ， 因 此 通常 
使 用 时 不 需要 特别 指明 是 标签 还 是 分 支 ， 可 以 省 略 。 所 以 说 ， 乍 一 



















































































@@ 这 样 操作 会 变 成 Detached HEAD 的 状态 。 相 关内 容 请 参考 专栏 。 
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看 标签 和 分 支 还 是 可 以 同名 的 。 

但 这 样 很 容易 造成 混乱 。 实 际 使 用 中 要 避免 标签 和 分 支 同 名 ， 
这 样 混 乱 也 会 相应 减少 。 万 一 出 现 同 名 的 情况 下 ， 可 以 通过 指定 命 
名 空间 来 明确 是 标签 还 是 分 支 。 请 记 住 这 一 点 。 











一 



























































@…… 标签 使 用 方法 总 结 


像 这 样 ， 通 过 用 标签 管理 系统 某 个 时 间 点 的 快照 ， 就 能 合理 地 进行 
版 本 管理 ， 在 发 生 故 障 后 查找 原因 时 ， 以 及 在 紧急 情况 下 的 系统 回 滚 
时 ， 也 能 发 挥 作用 。 

本 次 的 例子 中 ， 在 最 初 发 布 时 打 了 一 次 标签 。 之 后 处 理 故 障 ， 将 修 
改 合并 到 了 master， 因 此 待 QA 部 门 的 验收 测试 结束 ， 可 以 再 次 发 布 
时 ， 应 该 再 次 打上 标签 。 

$ git tag -a v0.1.1 -m "进行 了 issue 345 的 故障 处 理 " 

最 终 ， 合 理 使 用 分 支 和 标签 功能 之 后 ， 版 本 管理 系统 的 状态 如 图 

3.5 所 示 。 






























































图 3.5 ”活用 标签 


SS DS 


ae9884e lad2d9a2 lbdabe98| master 
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死 锁 问题 
的 修正 
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一 一 专栏 什么 是 Detached HEAD 











至 此 ， 我 们 一 起 看 了 使 用 分 支 和 标签 功能 的 基本 的 团队 开发 的 方 











法 。 下 一 节 我 们 将 研究 使 用 分 支 功 能 的 团队 开发 工作 流程 的 各 种 形式 。 





























执行 本 文中 的 命令 ， 会 显示 下 面 这 样 的 消息 。 
$ git checkout vO.1 


Netercgenesnocwe vo 


You are in 'detached HEAD' state. You can look around, make experimental 
changes and commit them, and you can discard any commits you make in this 
state without impacting any branches by performing another checkout. 


If you want to create a new branch to retain commits you create, you may 
do so (now or later) by using -b with the checkout command again. Example: 


git checkout -b new branch name 


HEAD is now at 8a4e89c... xxxx 
这 就 是 Detached HEAD 状态 。 不 必 建 立 分 支 就 能 实验 性 地 修改 
并 提交 ， 或 者 放弃 修改 。 执 行 git branch 命 令 ， 显示 如 下 。 


$$ git branch 
(detached from v0.1) 
master 


如 果 最 终 想 保留 在 这 个 状态 下 进行 的 各 类 实验 性 质 的 提交 的 话 ， 
E 新 建立 分 支 ， 并 切换 到 该 分 支 上 ， 就 能 将 提交 保存 下 来 。 
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口 
Seoneneeckeoue pnewbramnehname 

Detached HEAD 状态 虽然 是 很 方便 的 功能 ， 但 在 部 署 过 程 中 
获取 标签 的 时 候 ， 如 果 还 保持 Detached HEAD 状态 ， 管 理 上 就 很 
难 理解 。 所 以 要 像 本 文中 的 示例 始 就 新 建 分 支 ， 并 将 其 
checkout。 但 具体 做 法 还 是 要 结合 项 目 自身 的 情况 进行 探讨 。 
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3.6 ”Git 的 开发 流程 


到 这 里 为 止 ， 我 们 一 起 了 解 了 分 布 式 版 本 管理 系统 所 具有 的 灵活 
性 ， 以 及 Git 的 分 支 、 合 并 、 标 签 功能 的 便捷 和 高 速 。 

那么 ， 在 实际 使 用 Git 进行 团队 开发 的 过 程 中 ， 应 该 采用 怎样 的 开 
发 流程 呢 ? 

以 Subversion 为 代表 的 中 央 集 权 型 版 本 管理 系统 中 能 执行 的 项 目 并 
不 多 ， 所 以 开发 流程 也 自然 而 然 地 只 有 一 种 。 另 一 方面 ， 因 为 Git 过 于 
灵活 ， 所 以 容易 让 人 产生 困惑 ， 不 知道 应 该 采用 怎样 的 开发 流程 。 

老实 说 ，Git 开发 流程 现在 似乎 还 没有 固定 的 模式 。 原 因 之 一 是 Git 
不 仅 功能 丰富 而 且 非 常 灵活 ， 即 便 不 规定 流程 也 还 是 能 正常 使 用 。 本 节 
将 介绍 比较 常用 的 Git 工作 流 的 模式 。 










































































3.6.1 Git 工作 流 的 模式 


Git 的 工作 流 大 致 有 如 下 几 种 模式 。 


。 中 央 集 权 型 工作 流 
e GitHub 型 工作 流 


e-…… 中 央 集权 型 工作 流 

Pro Gi 中 也 举 过 这 样 的 例子 ， 即 像 以 前 的 Subversion 那样 设置 1 
个 中 央 代 码 库 ， 全 体 开 发 人 员 以 此 为 唯一 的 Push/Pull 对 象 ， 将 环境 克隆 
到 本 地 机 融 上 (图 3.6)。 























中 该 书 第 2 版 将 由 人 民 邮 电 出 版 社 出 版 。 一 一 编者 注 
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图 3.6 中 央 集 权 型 工作 流 





中 央 代码 库 








yf og 


发 人 员 























该 工作 流 的 优点 是 操作 和 Subversion 基本 相同 ， 思 考 方 式 也 不 需要 
太 大 的 改变 。 另 外 ,借助 把 Subversion 的 代码 库 视 作 Git 来 进行 交互 的 
工具 git-svn， 实 际 的 中 央 代 码 库 可 以 仍然 是 Subversion。 当 现 有 的 代码 
库 是 Subversion， 并 且 移 植 到 Git 的 成 本 很 高 时 ， 这 种 情况 下 该 工具 是 
非常 有 效 的 。 








@…… GitHub 型 工作 流 


Pro Git 中 称 之 为 “整合 经 理 型 工作 流 ”。 因 为 该 流程 和 GitHub 的 机 
制 基 本 相同 ， 所 以 本 书 称 之 为 GitHub 型 工作 流 。 

GitHub 型 工作 流 同 样 也 设置 1 个 代码 库 为 中 央 代 码 库 ， 但 开发 人 员 
会 各 自从 中 央 代 码 库 Fork 出 自己 的 远程 代码 库 ， 并 将 其 克隆 到 本 地 机 
器 上 。 

GitHub 型 工作 流 的 方式 是 ， 在 日 常 开发 中 将 修改 Push 到 Fork 出 的 
自己 专用 的 远程 代码 库 上 ， 当 修改 相对 稳定 后 ， 请 中 央 代 人 码 库 的 管理 者 
进行 Pull 操作 (图 3.7 )。 

这 样 的 流程 基本 就 是 GitHub 的 流程 。 其 优点 在 于 不 需要 等 待 中 央 
代码 库 的 维护 或 合并 操作 ， 各 开发 人 员 能 够 并 行 地 进行 作业 。 开 发 人 员 
有 有 自己 独立 的 代码 库 ， 可 以 在 代码 库 之 间 自 由 地 相互 Push/Pull。 这 也 
可 以 说 是 只 有 分 布 式 版 本 管理 系统 才 具 备 的 优点 。 
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3.7 GitHub 型 工作 流 








中 央 代码 库 各 开发 人 员 的 远程 代码 库 











管理 














在 Git 的 系统 上 应 用 该 流程 时 ， 因 为 没有 任何 约束 ， 所 以 运用 中 不 
注意 的 话 容易 造成 混乱 。 如 果 想 利用 这 种 方式 ， 推 荐 使 用 提供 以 这 种 方 
式 调整 后 的 工作 流 的 GitHub。 





3.6.2 ”分支 策略 的 模式 


在 已 经 设置 中 央 代 码 库 的 情况 下 ， 关 于 发 布 时 的 发 布 分 支 应 该 如 何 
处 理 、 开 发 时 是 否 要 建立 topic 分 支 、 修 正 bug 的 分 支 要 怎样 处 理 等 分 
支 运用 的 策略 也 有 着 各 种 各 样 的 模式 。 








@……. git-flow 


git-flow 是 2010 年 Vincent Driessen 在 “A successful Git branching 
model” 这 篇 博客 “中 提出 的 分 支 运用 策略 。 同 时 也 指 为 了 支持 该 分 支 策 
略 而 编写 的 工具 。 

该 分 支 策略 在 分 布 式 版 本 管理 系统 的 工作 流 中 稍 许 引 入 了 中 央 集 权 




















中 ”http:/nvie.com/posts/a-successful-git-branching-model/ 
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型 版 本 管理 系统 的 长 处 ， 可 以 说 是 结合 了 双方 优点 的 团队 开发 流程 。 通 
过 在 团队 内 部 统一 管理 建立 分 支 的 方法 、 合 并 的 做 法 以 及 关闭 分 支 的 方 








法 ， 来 实现 git-flow 分 支 策略 。 








git-flow 提议 以 固定 的 模式 在 中 央 代 码 库 中 建立 两 个 主 分 文 ， 在 各 
开发 人 员 的 代码 库 中 建立 3 个 辅助 分 支 (图 3.8 )。 








3.8 git-flow 








价 段 ，“ 
布 ”是 指 


之 后 的 发 布 











Feature Release ， 
分 支 Develop 分 支 Hotfixes master 







面向 下 一 次 
布 


> 





发 的 主 
| 功能 的 开发 


"A successful Git branching model" by Vincent Driessen ( 引 自 
http://nvie.com/posts/a-successful-git:branching-model/ ) 













紧急 bug 修了 





把 bug 修正 
合并 到 
【 Develop 中 


1.0 版 发 布 
分 支 的 开始 


民 浊 和合 了 
bug 修正 | 































从 发 布 分 支持 续 地 向 
Develop 分 支 合 并 bug 
多 正 的 内 容 




















想 详 细 了 解 该 分 支 策 略 的 读者 请 参考 上 述 博客 或 相关 资料 。 
图 3.8 中 的 各 个 分 支 的 含义 如 下 。 


e@ 主 分 支 











在 中 央 代 码 库 和 从 中 央 代 码 库 克隆 的 各 开发 人 员 的 代码 尼 











存在 的 








口 
UD 
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3.6 G 


主要 的 分 支 

© Master 
为 发 布 而 建 的 分 支 。 每 次 发 布 时 都 打上 标签 

O Develop 

开发 用 的 分 支 。 发 布 之 前 的 最 新 版 本 

e 辅助 分 支 
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原则 上 只 存在 于 各 开发 人 员 的 代码 库 中 ， 是 发 挥 相应 的 功能 后 就 被 删除 

















的 临时 分 支 


oO feature 























从 develop 分 离 出 来 的 被 用 于 开发 特定 功能 的 分 支 。 功 能 开发 结束 后 被 























合并 到 develop 中 





oO release 





















































从 develop 分 离 出 来 的 为 发 布 做 准备 的 分 支 。 在 发 布 的 准备 工作 期 间 ， 




















为 了 避免 多 余 的 feature 混杂 到 发 布 中 而 建立 的 分 支 


到 master 和 develop 中 











O hotfix 








。 发 布 结束 后 被 合 























主要 是 在 发 布 后 的 产品 发 生 故 障 时 紧急 建立 的 分 支 






































。 直 接 从 master 分 














离 ，bug 修正 后 再 合并 到 master 并 打上 标签 。 为 了 避免 将 来 遗漏 这 个 





bug 的 修正 ， 还 要 合并 到 develop。 如 果 此 时 











正在 发 布 作业 中 的 




















release 分 支 ， 还 要 向 release 进行 合 








这 样 的 分 文 策略 条 理 清晰 且 容 易 理解 ， 能 够 立刻 投入 到 实际 运用 
中 。 为 了 文 持 该 分 文 策略 ， 还 提供 有 Git 扩展 脚本 ( git-flow 脚本 )。 通 


























过 使 用 脚本 ， 运 用 会 变 得 更 加 容易 。 








在 有 一 定数 量 的 人 员 的 开发 中 ,按照 git-flow 分 支 策 略 这 样 整理 





管理 也 会 变 得 简单 。 





司 题 在 于 运用 有 些 复杂 ， 需 要 记忆 的 内 容 比 较 多 。 并 且 如 果 没 有 





提供 的 git-flow 脚本 的 话 ， 运 用 会 ri 





特别 是 在 使 用 GUI 











工具 的 情况 下 就 无 法 沾 到 git-flow 脚本 的 光 了 ， 





中 Atlassian 提供 的 SourceTree 工具 好 像 支持 git-flow 分 支 策略 。 
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需要 注意 "。 





@…… github-flow 











github-flow 是 由 Pro Git 的 作者 兼 GitHub 长 官 Scott Chacon 在 博客 ” 











中 发 表 的 GitHub 的 工作 流 。 

Scott Chacon 也 认为 git-flow 是 非常 出 色 的 ， 但 就 实际 运用 比较 复杂 
这 方面 ， 他 列举 了 如 下 问题 。 

问题 之 一 在 于 Git 本 身 就 绝 非 容易 理解 ， 此 外 还 必须 理解 分 支 
策略 。 

问题 之 二 在 于 使 用 GUI 工具 的 话 就 无 法 使 用 git-flow 脚本 ， 因 此 就 
不 得 不 自己 充分 理解 分 支 策 略 。 何 况 难 以 理解 分 文 策略 的 人 往往 也 无 法 
合理 使 用 git-flow 脚本 ， 这 样 的 人 最 终 就 无 法 合理 运用 git-flow。 
针对 上 述 问题 ，GitHub 采用 了 下 面 这 些 更 为 简单 的 做 法 。 这 就 是 所 
谓 的 github-flow。 

































































e master 的 内 容 都 可 以 进行 发 布 

e@ 添加 内 容 时 直接 从 master 新 建 分 支 

e 建立 的 分 支 在 本 地 环境 上 提交 ， 并 以 同名 的 分 支 定期 向 远程 代码 
库 进 行 Push 

e@ 开发 结束 后 向 master 发 送 Pull Request 

e@ Pull Request 通过 review 之 后 合并 到 master， 并 从 master 向 正 
式 环境 发 布 





还 有 一 点 在 上 述 项 目 中 没有 提 到 ， 那 就 是 github-flow 是 以 使 用 
GitHub 进行 开发 为 前 提 的 “。 
从 博客 的 图 片 中 可 以 看 出 ，github-flow 没有 Fork 中 央 代 码 库 ， 而 是 
采用 了 代码 库 唯 一 的 方式 ( 中 央 集 权 型 版 本 管理 系统 )。 
该 方式 的 特点 在 于 简单 、 易 于 理解 。 开 发 人 员 只 需要 记 住 以 下 3 点 
就 行 了 。 

















e master 是 用 于 发 布 的 ， 不 要 直接 在 master 上 进行 修改 





D http://scottchacon.com/2011/08/31/github-flow.html 
@ 因为 是 github-flow， 所 以 这 也 是 理 所 应 当 的 。 
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e 开始 作业 时 要 先 建立 分 支 
e 作业 结束 后 向 master 发 送 Pull Request? 


为 了 使 Pull Request 在 通过 review 之 后 能 立即 进行 合并 并 发 布 ， 在 
Pull Request 发 送 之 前 需要 在 本 地 进行 测试 ， 或 者 保持 使 用 Jenkins 等 CI 
工具 的 自动 化 测试 一 直 运 行 ， 这 是 github-flow 的 前 提 。 

当 正 式 环境 出 现 故 障 时 ， 也 只 需要 简单 地 从 master 建立 分 支 并 进行 
修正 ， 发 送 Pull Request 并 合并 ， 直 接 进 行 发 布 就 行 了 。 

像 GitHub 这 样 ， 通 过 保持 master 随时 都 能 发 布 来 简化 实际 的 运用 ， 
这 的 确 是 一 个 不 错 的 办 法 。GitHub 自身 一 天 之 内 要 进行 几 十 次 发 布 。 为 
了 实现 这 样 频 度 的 发 布 ， 就 必须 准备 好 CI 以 及 CD 的 环境 。 而 准备 这 
样 的 环境 是 比较 困难 的 。 



































@…… 笔者 的 例子 ( 折 囊 方案 ) 


git-flow 比较 倾向 于 发 布 间 隔 较 长 的 大 规模 项 目 ，github-flow 则 适用 

需要 时 常 发 布 的 具有 速度 感 的 项 目 ， 例 如 Web 服务 等 。 下 面 举 一 个 稍 
许 极端 的 例子 。 

笔者 所 属 的 团队 ， 因 为 git-flow 比较 复杂 所 以 没有 使 用 ， 实 际 运用 

的 是 定制 过 的 github-flow 形式 。 具 体 来 说 ， 就 是 像 下 面 这 样 。 















































e 以 使 用 GitHub 为 前 提 

e 采用 GitHub 形式 的 工作 流 ， 各 自在 GitHub 上 拥有 Fork 出 来 的 
远程 代码 库 。 

e@ 从 中 央 代 码 库 的 master 分 支 进行 发 布 

e 各 开发 人 员 可 以 在 自己 的 本 地 环境 和 远程 代码 库 上 随意 地 操作 

e 开发 结束 后 向 中 央 代 码 库 的 master 发 送 Pull Request 

e Pull Request 通过 review 后 合并 到 master 

e@ 在 发 布 准备 阶段 从 中 央 代 码 库 的 master 建立 发 布 分 支 

e 在 发 布 分 支 上 进行 回归 测试 、 部 署 测试 等 发 布 的 准备 工作 





中 ”Pull Request 不 仅 在 代码 库 之 间 ， 在 同一 代码 库 的 分 支 之 间 也 能 发 送 。 令 人 感到 
意外 的 是 不 知道 这 一 点 的 人 似乎 还 挺 多 的 。 
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e 在 进行 发 布 的 准备 工作 的 过 程 中 ， 开 发 人 员 仍 然 可 以 向 master 
发 送 新 功能 开发 的 Pull Request 
e@ 发 布 结束 后 合并 到 master， 在 master 上 打上 标签 后 删除 发 布 分 支 





大 体 的 形式 是 只 对 中 央 代 码 库 的 master 和 发 布 分 支 进行 严格 管理 ， 
其 他 的 都 可 以 随意 Fork， 自 由 使 用 。 这 种 方式 下 的 权限 管理 也 变 得 相对 
简单 ， 只 需要 对 向 master 发 送 的 Pull Request 认真 地 进行 代码 review 及 
测试 ， 其 余 的 事情 就 不 用 考虑 了 ， 这 也 是 该 方式 的 优点 之 一 。 

正式 环境 发 生 故 障 时 的 处 理 流程 是 ， 先 将 发 布 时 打上 的 标签 
checkout 到 本 地 机 器 上 并 进行 修正 ， 修 正 后 向 中 央 代码 库 的 master 发 送 
Pull Request， 合 并 Pull Request 后 建立 发 布 分 支 ， 发 布 结束 后 将 发 布 分 
支 合并 回 master 并 删除 。 虽 然 比 github-flow 步骤 稍微 多 了 一 些 ， 但 还 并 
不 是 太 复 杂 。 









































3.6.3 ”最 合适 的 流程 和 分 支 策 略 因 项 目 而 异 


本 节 我 们 了 解 了 使 用 Git 的 开发 流程 以 及 分 支 策略 。Git 系统 中 没有 
中 央 代 码 库 的 概念 ， 因 此 能 组 建 各 种 形态 的 工作 流程 。 这 样 的 灵活 性 正 
是 Git 的 魅力 所 在 ， 但 过 度 的 自由 事实 上 也 会 造成 很 多 麻烦 。 

接着 我 们 简单 地 看 了 具有 代表 性 的 流程 和 分 支 策略 。 还 介绍 了 笔者 
实际 运用 的 例子 。 有 具体 运用 方面 在 很 大 程度 上 会 受到 团队 的 商业 模式 的 
影响 。Web 服务 的 话 ， 只 需要 时 常 管 理 好 最 新 版 本 和 已 经 发 布 的 版 本 这 
两 个 就 行 了 。 而 如 果 是 套装 软件 的 话 ， 就 必须 同时 维护 多 个 版 本 ， 所 以 
还 是 有 所 差异 的 。 

另外 ,在 发 布 分 支 和 开发 分 支 的 操作 方面 ， 如 果 该 产品 是 不 经 过 长 
时 间 的 回归 测试 就 不 能 发 布 的 产品 的 话 ， 还 是 将 发 布 分 支 和 开发 分 支 区 
分 开 来 进行 管理 比较 好 。 另 一 方面 ， 如 果 是 应 该 尽早 发 布 的 服务 的 话 ， 
则 可 以 说 像 github-flow 那样 ， 完 全 不 区 分 比较 好 。 

Git 的 开发 流程 能 够 很 灵活 地 定制 ， 所 以 请 大 家 一 定 要 结合 项 目的 
具体 情况 ， 试 着 思考 一 下 最 合适 的 流程 。 
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3.7 ”数据 库 模式 和 数据 的 管理 


3.7.1 需要 对 数据 库 模式 进行 管理 的 原因 


团队 开发 中 ， 如 何 才 能 有 效 地 管理 数据 库 模式 "是 一 个 比较 棘手 的 
问题 ”。 在 多 人 修改 数据 库 的 情况 下 ， 容 易 因 漏 执 行 SQL 或 执行 顺序 出 
错 等 原因 造成 数据 库 的 数据 一 致 性 出 现 问题 。 

怎样 才能 解决 这 个 问题 呢 ? 由 于 该 问题 的 主要 原因 在 于 各 个 开发 人 
员 随 意 制作 SQL 修改 数据 库 模 式 ， 因 此 应 禁止 开发 人 员 修 改 数据 库 模 
式 ， 并 设置 数据 库 管理 员 一 职 ， 由 此 人 对 所 有 的 修改 进行 管理 ， 这 样 是 
不 是 就 能 够 解决 问题 了 呢 ? 

过 去 采用 这 种 方式 的 开发 现场 比较 常见 ， 但 从 以 下 这 些 原因 可 以 看 
出 这 种 方式 是 存在 问题 的 。 









































@…… 由 数据 库 管 理 员 负 责 对 修改 进行 管理 的 情况 


首先 ， 在 由 数据 库 管 理 员 负责 对 所 有 的 修改 进行 管理 的 情况 下 ， 如 
果 数 据 库 管理 员 成 为 瓶颈 的 话 ， 整 体 的 开发 速度 就 会 受到 影响 “。 



































@…… 修改 共享 数据 库 的 模式 的 情况 


其 次 ， 如 果 在 团队 中 共享 数据 库 ， 那 么 模式 的 变更 就 会 波及 到 整个 
团队 ， 影 响 开发 进度 。 模 式 发 生变 更 时 ， 首 先 程序 的 代码 也 无 疑 会 发 生 
变化 ， 若 修改 共享 数据 库 的 模式 ， 各 个 开发 成 员 的 代码 和 数据 库 模 式 就 
难免 会 发 生 背 离 。 因 此 可 以 说 对 数据 库 模式 也 应 该 进行 版 本 管理 。 





























是 对 数据 库 构 造 的 定义 。 

以 第 2 章 的 问题 4 为 例 。 

根据 项 目的 规模 ， 设 置 数据 库 管 理 员 也 是 必要 的 ， 因 为 有 数据 库 的 调整 或 备份 等 
本 来 应 该 由 数据 库 管 理 员 负责 的 业务 。 


四 提 日 
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3.7.2 ”应 该 如 何 管理 数据 库 模 式 


对 数据 库 模 式 进行 版 本 管理 ， 应 该 管理 什么 ?又 怎么 管理 呢 ? 让 我 
们 具体 地 来 看 一 下 。 这 里 假设 数据 库 为 MySQL 或 PostgreSQL 等 ， 也 就 
是 说 使 用 了 RDBMS ， 以 此 为 前 提 来 继续 下 面 的 话题 。 但 是 这 里 的 数据 
库 并 不 局 限于 RDBMS ， 文 本 文件 、XML 文件 、 对 象 数据 库 以 及 最 近 使 
用 频率 逐渐 增加 的 MongoDB 等 NoSQL 数据 库 ， 它 们 的 思考 方法 也 是 
完全 相同 的 。 
































@.……. 版 本 管理 的 必要 条 件 
对 数据 库 模 式 进行 版 本 管理 的 必要 条 件 中 ， 比 较 重 要 的 是 以 下 3 个 。 








e 无 论 什么 环境 都 能 用 相同 的 步骤 来 构建 数据 库 
e 能 够 反复 执行 多 次 
e 文本 文件 


上 面 这些 也 是 和 CI 相关 联 的 思考 方法 。CI 相关 的 内 容 将 在 第 5 章 
进行 说 明 。 对 于 数据 库 模式 ， 和 代码 一 样 进行 版 本 管理 ， 无 论 任何 环境 
都 能 反复 构建 ， 这 一 点 是 非常 重要 的 。 另 外 ， 为 了 用 版 本 管理 系统 方便 
地 进行 合并 ， 以 文本 文件 的 形式 管理 模式 也 是 很 重要 的 。 

例如 有 的 开发 现场 使 用 商用 的 GUI 工具 来 建立 数据 库 模 式 ， 这 样 的 
工具 有 时 反而 会 影响 团队 开发 的 效率 。 因 此 一 定 要 以 程序 能 够 反复 执行 
的 文本 文件 形式 来 管理 数据 库 模 式 。 
























































e…… 什么 是 数据 库 迁 移 


数据 库 模式 的 CI 称 为 CDBI ( Continuous DataBase Integration )。 
《持续 集成 : 软件 质量 改进 和 风险 降低 之 道光 中 也 以 专门 的 章节 对 其 进 
行 了 说 明 。 但 是 最 近 比 起 CDBI， 使 用 从 Ruby on Rails 的 工具 名 
( Migration ) 衍生 而 来 的 “数据 迁移 ”这 个 叫 法 的 人 似乎 更 多 一 些 。 本 
































中 ( 美 ) Paul M. Duvall 、Steve Matyas、Andrew Glover 著 ， 王 海 鹏 译 ， 电 子 工 业 出 
版 社 ，2012 年 。 
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书 也 以 数据 迁移 这 个 用 语 来 继续 下 面 的 解说 。 
如 今 发 布 了 很 多 数据 迁移 用 的 工具 和 框架 ,借助 这 些 工具 ， 能 比较 
简单 地 实现 数据 迁移 。 

















@…… 数据 库 迁 移 的 功能 


如 前 所 述 ， 作 为 数据 库 迁 移 工 具 ，Ruby on Rails 的 Migration 是 比 
较 有 名 的 。 顺 便 说 一 下 ， 笔 者 所 在 的 公司 是 自己 开发 原生 的 工具 进行 数 
据 迁 移 的 。 的 确 ，Ruby on Rails 从 诞生 以 来 也 只 经 过 了 10 年 左右 的 时 
间 ， 还 算是 比较 新 的 架构 。 业 务 持续 了 10 年 以 上 的 公司 中 ， 独 自 开 发 
工具 进行 数据 迁移 的 情况 还 是 比较 多 的 。 

不 同 的 工具 在 实现 的 细节 方面 有 细小 的 差异 ， 但 基本 的 构思 几乎 都 
是 相同 的 。 笔 者 所 在 的 公司 开发 的 工具 和 以 Ruby on Rails 的 Migration 
为 代表 的 工具 大 体 上 都 是 以 下 面 这 样 的 构思 来 制作 的 。 



















































































e 管理 SQL 执行 的 顺序 和 需要 执行 哪些 SQL 
e 管理 模式 定义 编辑 的 冲突 

e 提供 回 滚 的 机 制 

e 支持 数据 的 加 载 


SQL 的 模式 定义 (DDL，Data Definition Language ) 和 数据 加 载 
( DML，Data Manipulation Language ) 是 有 执行 顺序 的 。 如 同 我 们 在 第 2 
章 的 问题 4 中 所 见 到 的 那样 ， 执 行 顺序 发 生变 化 后 意义 也 会 随 之 改变 ， 
所 以 需要 对 执行 顺序 以 及 在 各 个 环境 中 需要 执行 哪些 SQL 进行 管理 。 
因此 大 部 分 工具 都 在 数据 库 中 建立 管理 表 ， 或 者 用 专门 的 XML 文件 来 
管理 执行 顺序 和 需要 执行 哪些 SQL 等 。 

为 了 避免 冲突 ， 通 常会 为 SQL 文件 确立 某 种 命名 规则 。 具 体 来 说 ， 
有 的 以 日 期 作为 文件 名 ， 将 相同 日 期 的 SQL 全 部 放 入 同一 文件 ; 有 的 以 
连续 的 数字 作为 文件 名 ， 文 件 名 相同 的 话 则 进行 合并 等 。 

受 Ruby on Rails 的 Migration 的 影响 ， 如 今 的 工具 基本 都 提供 了 回 
滚 的 机 制 。 制 作文 件 时 会 在 同一 文件 中 记载 回 滚 用 的 SQL。CREATE 语 
名 对 应 DROP，INSERT 语句 对 应 DELETE， 这 样 执行 用 的 SQL 和 回 滚 
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用 的 SQL 就 可 以 成 对 地 进行 管理 。 

数据 加 载 方 面 和 模式 定义 相同 ， 比 较 多 的 工具 采用 在 文件 中 记载 
INSERT 或 UPDATE 的 方法 进行 管理 。 并 且 这 里 的 数据 主要 是 系统 初始 
化 设置 所 必需 的 数据 。 例 如 税率 的 数据 或 超级 用 户 的 数据 等 。 可 以 理解 
为 和 用 户 的 使 用 状况 无 关 ， 系 统 启动 时 所 必需 的 数据 。 

请 注意 这 里 加 载 的 数据 不 包括 单 体 测试 和 结合 测试 所 需要 的 数据 。 
测试 数据 不 属于 初始 化 数据 ， 而 属于 用 户 数据 。 这 部 分 数据 应 该 通过 
Fixture "等 机 制 在 测试 程序 中 加 载 。 测 试 部 分 的 数据 管理 将 在 第 $ 章 进 
行 说 明 。 















































SHS 
接 下 来 将 对 主流 的 数据 库 迁 移 工具 进行 说 明 。 在 因为 某 些 原因 无 法 
使 用 工具 的 情况 下 ， 可 以 考虑 自己 制作 符合 要 求 的 原生 工具 。 通 过 对 数 
据 库 模 式 实行 版 本 管理 ， 项 目的 品质 和 速度 将 会 有 突破 性 的 飞跃 。 



























































3.7.3 ”数据 库 迁移 工具 





现在 已 经 出 现 了 各 种 各 样 的 数据 库 迁 移 工 具 ， 并 且 几 乎 所 有 最 近 的 
Web 应 用 程序 框架 中 都 自 带 数 据 库 迁 移 工具 。Web 应 用 程序 框架 自 带 的 
工具 主要 有 以 下 这 些 。 
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@……Migration ( Ruby on Rails ) 








现在 Web 应 用 程序 框架 的 先驱 Ruby on Rails 自 带 的 工具 。 其 他 的 
工具 几乎 都 受 它 的 影响 。 为 了 管理 SQL， 会 在 数据 库 中 建立 名 为 
system_setting 的 表 。 








i south ( Django ) 





比较 有 名 的 Python 框架 Django 中 自 带 的 名 为 south 的 工具 。 








Q 将 测试 所 需要 的 数据 预先 加 载 到 数据 库 中 的 机 制 。 为 了 能 够 反复 测试 ， 通常 
Fixture 会 在 执行 测试 前 加 载 数据 ， 在 测试 结束 后 删除 数据 。 像 这 样 预先 提供 数据 
加 载 和 删除 这 两 个 功能 的 情况 是 比较 多 见 的 。 
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Oe Migrations Plugin ( CakePHP ) 
PHP 的 框架 CakePHP 中 为 了 进行 数据 迁移 而 提供 的 插件 。 
Oe Evolution ( Play Framework ) 


Java 和 Scala 的 框架 Play Framework 中 作为 标准 自 带 的 名 为 
Evolution 的 工具 。 








过 





SHH 
也 有 不 局 限于 特定 的 Web 应 用 程序 框架 的 通用 迁移 工具 。 这 类 工具 
的 数量 比较 多 ， 我 们 这 里 只 介绍 一 小 部 分 能 够 用 Java 调用 的 工具 。 
































® Flyway” 
® Liquibase” 
® dbdeploy’ 


每 个 工具 的 功能 都 差不多 ， 所 以 选择 与 项 目 相 适应 的 ， 可 以 使 用 的 
工具 就 行 了 。 

如 果 要 在 已 有 的 应 用 程序 中 导入 迁移 工具 ， 那 么 使 用 不 依赖 于 框架 
的 工具 会 比较 好 。 还 有 一 些 Java 的 项 目 ， 只 是 为 了 使 用 Migration 而 特 
地 导入 Ruby on Rails， 这 人 么 做 的 开发 现场 也 是 有 的 。 









































3.7.4 具体 用 法 ( Evolution ) 








关于 数据 迁移 工具 的 用 法 ， 这 里 以 笔者 作为 提交 者 〈committer ) 的 
Play Framework 为 例 来 进行 说 明 。Evolution 和 老大 哥 Migration 比 起 来 
功能 上 要 简单 很 多 ， 但 必要 的 功能 都 有 了 。 











Evolution 和 其 他 类 似 的 工具 一 样 ， 对 于 文件 名 、 记 载 的 内 容 、 存 放 





(LV http://flywaydb.org/ 
©® http:/www.liquibase.org/ 
® http://dbdeploy.com/ 
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的 目录 等 都 有 规定 。 


e SQL 文件 以 1.sql、2.sql 这 样 连续 的 数字 命 
e@ 一 定 要 放 在 程序 的 conf/evolutions/{ 数据 库 名 } 的 目录 下 


e SQL 文件 中 必须 要 有 Ups 和 Downs 这 两 部 分 的 定义 


例如 像 下 面 这 样 定义 1.sql 文件 。 
# User 表 
# === !Ups 


CREATE TABLE User ( 
id bigint (20) NOT NULL AUTO_INCREMENT, 
email varchar (255) NOT NULL, 
password varchar (255) NOT NULL, 
name varchar (255) NOT NULL, 
creatnat dacenNUne 
update at date NULL, 
PRIMARY KEY (id) 
De 


# --- !Downs 


DROP TABLE User; 


e…… SQL 文件 的 执行 


Play Framework 在 存在 SQL 文件 的 状态 下 启动 程序 就 会 自动 执行 
Evolution 的 处 理 ”。 处 理会 对 比 本 地 机 器 上 的 数据 库 和 Evolution 的 SQL 
文件 ， 如 果 发 现 有 没有 被 执行 的 SQL， 就 会 在 浏览 器 中 显示 如 图 3.9 这 
样 的 消息 ， 提 示 执 行 SQL。 



































中 Ups 部 分 记载 需要 执行 的 SQL 的 定义 ， 与 之 相对 ，Downs 部 分 记载 的 是 将 Ups 
部 分 的 内 容 回 滚 时 需要 执行 的 SQL。 如果 Ups 部 分 是 Create 的 话 ，Downs 部 分 
就 是 Drop， 大 致 就 是 这 个 样子 。 详 细 的 处 理 稍 后 进行 讲解 ， 大 概 机 制 是 当 版 本 管 
理 系统 中 的 SQL 和 实际 的 数据 库 状 态 之 间 的 一 致 性 出 现 问题 时 ， 就 运行 Downs 
部 分 的 内 容 进 行 回 滚 。 

Ruby on Rails 的 情况 下 不 是 SQL 文件 ， 而 是 用 Ruby 写 的 单独 的 DSL 文件 。 

当然 也 可 以 设置 为 不 自动 执行 。 
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© CT ,9 


Database ‘default'" needs evolution! 


二 | Apply this script now! 





This SQL script must be run: 


# 11! WARNING! This script contains DOWNS evolutions that are likely destructives 


# --- Rev:1,Downs - e0b80b4 
DROP TABLE User; 


# --- Rev:1,Ups - aa6208e 

CREATE TABLE User ( 

id bigint(20) NOT NULL AUTO_INCREMENT, 
email varchar(255) NOT NULL, 

password varchar(255) NOT NULL， 

name varchar(255) NOT NULL， 

creat_at date NULL， 

update_at date NULL, 

PRIMARY KEY (id) 

); 


四 mA 


PP bb 
AruNPpe 














按 下 “Apply this script now!” 就 会 执行 SQL 文件 。 关 于 这 方面 ， 
Ruby on Rails 的 Migration 采用 的 是 命令 行 操作 模式 ，Play Framework 
采用 的 是 对 话 模式 ”。 交 互 模式 虽然 不 同 ,但 想 要 处 理 的 内 容 是 相同 的 。 




















e…… 开发 者 之 间 数 据 库 模式 的 同步 
假设 开发 人 员 A 为 添加 表 而 新 建 了 2.sql 文件 。 


# Company 添加 








#0 Ups 

CREATE TABLE Company ( 
id bigint (20) NOT NULL AUTO_INCREMENT, 
name varchar (255) NOT NULL, 
location varchar (255) NOT NULL, 
description text NOT NULL, 
url varchar (255) NOT NULL, 





@ 最 新 的 Ver2 只 能 使 用 对 话 模式 进行 处 理 。Verl 也 可 以 用 命令 行 模式 进行 操作 。 
希望 Ver2 的 Evolution 也 能 早日 支持 命令 行 模式 。 
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ereatnate dtenNyn 
update at date NULL, 
PRIMARY KEY (id) 

就 


# -=-= !Downg 
DROP TABLE Company; 


在 A 的 数据 库 中 执行 该 SQL。 
这 时 开发 人 员 B 正好 想 给 1.sql 中 建立 的 User 表 增 加 一 列 。 
知道 A 已 经 建立 了 2.sql， 所 以 B 在 本 地 机 器 上 又 建立 了 2.sql。 


# User 修改 











# --- !Ups 
ALTER TABLE User ADD age INT; 


# -=-- !Downs 
ALTER TABLE User DROP age; 








因为 不 


开发 结束 后 ，B 向 中 央 代 码 库 Push 新 建 的 文件 。 之 后 A 也 进行 


Push， 但 因为 B 提交 的 2.sql 已 经 存在 ， 所 以 结果 产生 冲突 了 。 


<<<<<<< HEAD 
# Company 添加 


# --- !Ups 

CREATE TABLE Company ( 
id bigint (20) NOT NULL AUTO_ INCREMENT, 
name varchar (255) NOT NULL, 
location varchar (255) NOT NULL, 
description text NOT NULL, 
url varchar (255) NOT NULL, 
ereatat date NUD 
update at date NULL, 
PRIMARY KEY (id) 

J 


# --- !Downs 
DROP TABLE Company; 


# Update User 


# --- !Ups 
ALTER TABLE User ADD age INT; 


# --- !Downs 
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ALTER TABLE User DROP age; 


>>>>>>> devB 
合并 后 的 代码 如 下 所 示 。 
# Company 添加 


# --- liUps 
ALTER TABLE User ADD age INT; 


CREATE TABLE Company ( 
id bigint (20) NOT NULL AUTO_INCREMENT, 
name varchar (255) NOT NULL, 
location varchar (255) NOT NULL, 
description text NOT NULL, 
url varchar (255) NOT NULL, 
Cre eeteenyli 
update at date NULL, 
PRIMARY KEY (id) 
Dy 


# --- !Downs 
ALTER TABLE User DROP age; 


DROP TABLE Company; 
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合并 后 新 的 2.sql 和 执行 了 旧 的 2.sql 的 开发 人 员 A 的 数据 库 之 间 已 








经 有 了 差异 。Evolution 会 检查 出 该 差异 ， 回 深 掉 旧 的 数据 库 模 式 ， 并 和 
回 深 到 执行 2.sql 之 











新 建立 新 的 模式 。 回 滚 处 理 时 会 用 到 Downs 部 分 ， 

















[EN 





前 的 状态 后 ， 再 重新 执行 Ups 部 分 。 在 此 之 后 ， 如 果 B 进行 Pull，B 的 


数据 库 也 会 被 回 演 ， 然 后 被 重新 建立 。 
这 样 ， 多 人 各 自持 有 的 数据 库 模式 就 都 得 到 了 同步 。 


一 致 性 问题 的 管理 




















由 于 某 些 原因 ， 执 行 SQL 也 会 有 失败 的 时 候 。 例 如 合并 SQL 时 出 


现 问题 ，4 





E 成 了 自 相 巴 盾 的 SQL， 并 目 





| 没有 注意 就 执行 了 该 SQL。 这 时 





Evolution 会 检测 出 错误 ， 作 为 模式 不 一 致 的 状态 进行 管理 ( 图 3.10 )。 
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| 四 





图 3.10 ”一 致 性 问题 的 管理 ( Sy Framework ) 


e A http%3A%2F%2Flocalhost%3A9000. | 


Database ‘default"' is in inconsistent 
state! 


An evolution has not been applied properly. Please check the problem and resolve it 
a 


We got the following error: 列 名 “EMAIL” 洲 重 复 L 习作 末 才 Duplicate column name "EMAIL"; SQL 
statement: CREATE TABLE User ( id bigint(20) NOT NULL AUTO_INCREMENT, email varchar(255) 
NOT NULL, password varchar(255) NOT NULL, name varchar(255) NOT NULL, email varchar(255) 
NOT NULL, creat_at date NULL, update_at date NULL, PRIMARY KEY (id) ) [42121-168] 
[ERROR:42121, SQLSTATE:42S21], while trying to run this SQL script: 


# --- Rev:1,Ups - eg0b80b4 


CREATE TABLE User ( 

id bigintC20) NOT NULL AUTO_INCREMENT, 
email varchar(255) NOT NULL， 

password varchar(255) NOT NULL， 

name varchar(255) NOT NULL, 

email varchar(255) NOT NULL， 

creat_at date NULL, 


wo Naw un | 


19 update_at date NULL, 
11 PRIMARY KEY (Cid) 
We ); 


© 









































显示 上 述 画 面 时 ， 可 以 通过 手动 执行 SQL 进行 修正 后 再 按 下 Mark 
it resolved 按 键 , 或 者 修改 原 有 的 SQL 文件 后 再 运行 Evolution 的 
方法 来 解决 。 

这 样 ， 通 过 对 SQL 的 错误 进 
成 为 了 可 能 。 

















3 
二 
咕 
H 王 


里， 使 得 


其 
出 


晶 正 确 的 数据 库 模 式 




















3.7.5 数据库 迁移 中 的 注意 点 


对 数据 库 迁 移 文件 (Evolution 的 话 是 SQL 文件 ，Migration 的 话 是 
Ruby 文件 ) 进行 版 本 管理 时 ， 判 断 合并 的 结果 是 否 正确 是 一 个 比较 伤 
脑筋 的 问题 。 

RDBMS 的 数据 库 构 建 可 以 说 只 要 不 出 现 错误 就 应 该 没什么 问题 ， 
但 无 法 保证 合并 后 的 SQL 一 定 正确 ， 因 此 需要 对 数据 库 模 式 的 正确 性 
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进行 测试 。 
这 个 和 代码 的 合并 道理 相同 。 代 码 也 是 合并 后 的 文件 只 要 能 通过 编 
译 就 基本 可 以 说 没 问 题 了 ,但 从 程序 的 角度 来 看 ， 正 确 与 否 a 


试 才 知 道 。 
只 要 使 用 数据 库 迁移 ， 数 据 库 的 变更 管理 就 万 无 一 失 ， 这 样 的 说 法 
过 于 草率 ,测试 还 是 必须 的 ， 这 一 点 请 注意 。 应 该 编写 测试 程序 ， 做 到 
随时 都 能 够 自动 进行 测试 。 因 此 应 该 将 数据 库 迁 移 作为 CI 的 一 个 环节 ， 
纳入 到 CI 之 中 。CI 的 相关 内 容 将 在 第 5 章 进行 说 明 。 
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3.8 配置 文件 的 管理 


如 同 我 们 在 第 2 章 的 问题 10 中 见 到 的 那样 ， 由 于 环境 不 同 ， 对 依 
赖 环境 的 各 种 配置 文件 也 要 进行 版 本 管理 。 首 先 ， 程 序 方面 的 配置 应 该 
把 每 个 环境 的 配置 文件 分 开 进 行 管理 。 例 如 数据 库 或 memcached 等 中 间 
件 的 连接 地 址 配置 “或 程序 本 身 固有 的 配置 等 。 现 代 的 Web 程序 框架 一 























般 都 会 提供 这 样 的 机 人 
































出 ， 请 直接 使 用 。 即 便 出 错 了 ， 也 不 要 采用 手动 替 














换 staging 环境 或 正式 环境 中 的 配置 文件 这 样 的 方式 。 
将 所 有 资源 都 置 于 版 本 管理 系统 之 下 ， 只 使 用 版 本 管理 系统 中 的 文 
件 ， 任 何人 都 可 以 随时 自动 化 地 执行 程序 的 构建 到 启动 的 所 有 过 程 ， 只 





有 这 样 才能 维持 优质 、 
接着 是 Apache、 











身 的 配置 文件 的 管理 。 这 些 中 间 件 基本 上 都 没有 根据 不 同 的 环境 分 别 进 











快速 的 开发 。 
MongoDB、memcached、PostgreSQL 等 中 间 件 自 




















行 配置 的 功能 。 因 此 大 多 数 的 公司 都 独立 开发 构筑 服务 咒 用 的 安装 脚 
本 ， 或 者 在 目录 结构 和 符号 链接 方面 下 功夫 ， 以 尽 可 能 地 把 中 间 件 的 安 
装 到 配置 的 过 程 简单 化 。 

通常 部 署 程序 的 服务 器 由 多 台 组 成 ， 如 果 不 能 有 效 地 管理 配置 文 





件 ， 要 进行 快速 的 发 








布 是 不 可 能 的 。 现 在 用 于 解决 上 述 问题 的 工具 有 


Chef、Puppet、Capistrano 、Fabric 、ServerSpec 等 。 使 用 这 些 工具 的 管 
理 方法 将 在 第 6 章 进行 说 明 。 











中 ”以 数据 库 为 代表 的 中 间 件 的 连接 信息 中 一 般 会 包括 密码 。 将 密码 这 样 的 信息 直接 


提交 到 版 本 管理 系统 的 代码 库 可 能 会 产生 安全 方面 的 问题 ， 这 点 需要 注意 。 通 常 


只 将 开发 环境 的 密码 


提交 到 版 本 管理 系统 ， 不 提交 staging 环境 或 正式 环境 的 密 


码 ， 而 使 用 部 署 脚 本 在 每 次 发 布 时 进行 密码 设置 。 
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3.9 依赖 关系 的 管理 














开发 具有 一 定 规模 的 程序 时 ， 难 以 避免 地 会 使 用 到 一 些 库 。 程 序 所 














依赖 的 库 的 依赖 关系 的 定义 也 应 该 作为 版 本 管理 的 对 象 。 





3.9.1 依赖 关系 管理 系统 














现在 各 开发 语言 一 般 都 会 提供 以 下 3 点 的 组 合 。 








e 管理 通用 库 的 仓库 
e 定义 对 库 的 依赖 关系 的 文件 
e 使 用 上 述 文件 实际 管理 依赖 关系 的 脚本 





下 面 列举 各 玫 

















二 JVM 语言 














发 语言 提供 的 一 些 主要 工具 。 


为 了 管理 Java 或 Scala 等 在 JVM 上 运行 的 语言 的 依赖 关系 ， 有 着 








各 种 各 样 的 工具 。 


® Apache Ant” ( +Apache ivy” ) 


® Maven® 
® sbt” 


® Gradle® 





2 


€ 


轩 旬 四 的 


http://ant.apache.org/ 


https://ant.apache.org/ivy/ 
http://maven.apache.org/ 
http://www.scala-sbt.org/ 
http://www.gradle.org/ 
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如 果 制 作 了 可 以 作为 OSS 公开 的 通用 库 的 话 ， 只 要 上 传 到 上 述 仓 








这 些 工 具 都 参照 下 面 Maven 的 仓库 作为 共通 的 仓库 。 














e Maven 中 央 仓库 ? 
e Sonatype ( 中 央 仓 库 镜像 ) ” 














就 能 在 全 世界 范围 内 共享 。 
还 可 以 在 公司 内 部 构建 Maven 的 仓库 。 只 想 在 公司 内 部 共享 的 库 
可 以 上 传 到 公司 内 部 的 Maven 仓库 中 进行 管理 。 




















每 个 脚本 语言 都 有 自己 各 式 各 样 的 依赖 关系 的 管理 工具 。 





e CPAN”( Perl ) 
e PyPI ( Python ) 
e RubyGems® ( Ruby ) 


e npm" (Node.js ) 




















和 JVM 语言 不 同 ， 脚 本 语言 的 仓库 和 工具 是 相同 的 。 这 是 因为 脚 








本 语言 较 早 地 采用 了 包 (package ) 管理 的 思考 方式 ， 并 一 直 在 进行 整 
理 。 男 一 方面 ，JVM 语言 因为 长 时 间 没有 采用 这 种 思考 方式 ， 所 以 各 类 
工具 显得 有 点 混乱 。 














本 管理 依赖 关系 的 优点 





例如 Maven 中 的 依赖 关系 可 以 像 下 面 这 样 定 义 。 











<dependencies> 


<dependency> 





OG@OQOO0O 


http://search.maven.org 
https://0ss.sonatype.org 
http://www.cpan.org/ 
https://pypi.python.org/pypi 
http://rubygems.org/ 
https://npmjs.org/ 
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<groupId>org.jyaml</groupId> 
=artrnftactetdsy aml /artntactTld> 
<version>1.3</version> 

</dependency> 

<dependency> 
<groupId>junit</groupId> 
=artiftactelida un /artitackTld> 
<version>4.11</version> 

</dependency> 

</dependencies> 


这 样 定义 后 ，Maven 会 自动 地 从 仓库 中 找 出 jyaml 和 junit， 并 将 其 
加 到 ClassPath 中 。 如 果 只 是 处 理 这 些 的 话 ， 你 可 能 会 觉得 这 和 在 网 上 
查找 库 并 手动 下 载 ， 然 后 再 添加 到 ClassPath 没什么 区 别 。 事 实 上 并 非 
如 此 。 

不 仅 是 Maven， 上 述 列 举 的 各 个 工具 都 还 能 够 管理 传递 依赖 。 具 体 
来 说 ， 如 果 jyaml 和 junit 自身 有 依赖 的 库 的 话 ， 就 会 对 其 进行 查找 ， 找 
到 的 库 如 果 还 依赖 其 他 的 库 ， 则 继续 查找 下 去 。 也 就 是 说 ， 这 些 工具 具 
有 自动 管理 所 有 传递 的 依赖 关系 的 机 制 。 

这 样 ， 依 赖 关 系 也 能 作为 可 以 重复 执行 的 内 容 被 纳入 到 版 本 管理 的 
对 象 之 中 了 。 如 果 手 动 操 作 的 话 ， 不 仅 容易 遗漏 库 ， 再 加 上 环境 差异 等 
原因 ， 也 非常 麻烦 。 因 此 在 开发 现场 依赖 管理 工具 是 必 不 可 少 的 。 

上 面 以 Maven 为 例 进行 了 说 明 。 其 实 CPAN 也 好 ，RubyGems 也 
好 ， 基 本 的 思考 方式 都 是 一 样 的。 在 接 下 来 的 开发 中 ， 让 我 们 一 起 使 用 
依赖 管理 系统 进行 有 效 地 管理 吧 “。 




































































@ 各 个 工具 的 详细 用 法 在 Web 上 有 很 多 相关 的 信息 可 供 参考 。 
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至 此 我 们 一 起 确认 了 什么 是 版 本 管理 系统 ， 一 边 回 顾 版 本 管理 系统 
的 历史 ,一边 介绍 了 如 今 的 开发 现场 所 面临 的 问题 。 还 了 解 了 分 布 式 版 
本 管理 系统 的 使 用 方法 、 版 本 管理 系统 应 该 管理 的 内 容 以 及 有 效 的 管理 
方法 。 

这 样 就 能 够 记录 下 什么 时 候 、 谁 、 进 行 了 怎样 的 修改 ， 任 何 时 候 都 
可 以 进行 追查 。 并 且 还 能 够 做 到 根据 需要 回 滚 到 过 去 某 一 时 刻 、 多 版 本 
并 行 开发 、 有 效 地 进行 数据 库 的 模式 变更 管理 。 

但 是 只 有 版 本 管理 系统 的 话 还 是 不 知道 为 什么 要 进行 这 样 的 修改 ， 
解决 这 个 问题 就 需要 用 到 缺陷 管理 系统 。 

在 接 下 来 的 第 4 音 ， 我 们 将 一 起 看 一 下 缺陷 管理 系统 的 有 效用 法 ， 
特别 是 和 版 本 管理 系统 联动 的 方法 。 





站 
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4.1 缺陷 管理 系统 


4.1.1 项 目 进 展 不 顺利 的 原因 


如 果 参 加 项 目的 多 名 成 员 同 时 还 兼任 其 他 工作 ， 那 么 在 推进 项 目的 
过 程 中 重要 的 就 是 任务 整理 、 进 度 管理 和 信息 共享 。 

项 目 成 功 / 失 败 的 形式 各 种 各 样 ， 并 且 不 同 的 项 目 和 团队 对 于 成 功 / 
失败 的 定义 也 各 不 相同 。 并 不 是 完成 了 所 有 的 任务 就 是 成 功 。 例 如 ， 即 
使 所 有 的 任务 都 按时 完成 了 ， 但 如 果 最 终 没 有 到 达 当 初 制定 的 目标 ， 不 
也 可 以 称 之 为 失败 吗 ? 

话 虽 如 此 ,项 目 能 够 进展 到 可 以 评判 成 功 /失败 的 阶段 可 以 说 还 算 
不 错 的 了 。 在 这 之 前 ， 有 的 项 目 就 已 经 出 现 “进展 不 顺利 、 结 束 不 了 ” 
的 情况 了 。 笔 者 有 过 很 多 这 样 的 经 历 ， 相 信 读 者 也 有 类 似 的 记忆 吧 。 

项 目 “ 进 展 不 顺利 、 结 束 不 了 ”的 原因 各 种 各 样 ， 大 致 有 下 面 这 些 。 










































































。 目标 错误 
。 估计 错 误 ， 时 间 过 紧 ， 人 员 不 足 
。 没 有 定义 项 目的 结束 

。 成 员 的 积极 性 不 足 ， 进 度 停滞 不 前 








从 笔者 的 经 验 来 看 , “进展 不 顺利 、 结 束 不 了 ”的 项 目 有 着 以 下 这 
些 共同 的 特征 。 


e 项 目 无 法 可 视 化 
e 没有 进行 任务 整理 、 进 度 管理 和 信息 共享 等 


换言之 ， 这 样 的 项 目 多 数 都 没有 做 到 “必须 要 做 什么 ”这 样 的 任务 
定义 、 由 “ 谁 ” 在 “什么 时 候 完成 ”这 样 的 责任 人 和 期 限 的 管理 、“ 以 
什么 作为 结束 ”这 样 的 任务 完成 的 定义 ， 以 及 “现在 正在 作业 中 还 是 已 
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经 完成 了 ”这 样 的 进度 管理 。 

但 是 不 进行 任务 管理 的 项 目 真 的 存在 吗 ?毕竟 笔者 还 没有 听 说 过 这 
羊 的 事情 ， 无 论 哪个 现场 都 应 该 以 某 种 形式 对 任务 进行 管理 。 那 为 什么 
还 会 有 进展 不 顺利 的 项 目 呢 ? 这 可 能 是 因为 管理 方法 的 问题 。 





了 
Tt 
beam 
Xp 
川中 




















4.1.2 ”用 纸 、 邮 件 、Excel 进行 任务 管理 时 的 问题 


最 近 ， 随 着 缺陷 管理 系统 的 导入 ， 像 第 2 章 问题 1 那样 用 邮件 管理 
全 部 内 容 的 开发 现场 已 经 越 来 越 少 了 。 

即便 如 此 ， 不 使 用 缺陷 管理 系统 也 能 够 实现 任务 管理 、 进 度 管理 和 
信息 共享 。 年轻 的 读者 之 中 可 能 有 人 不 知道 ， 在 过 去 的 开发 现场 ， 进 度 
管理 是 用 名 为 “bug 票 ” “问题 管理 表 ” 这 样 纸 质 的 管理 票 和 账本 来 进行 
的 。 还 有 的 开发 现场 用 Excel 制作 问题 管理 表 来 进行 管理 。 如 果 是 小 规 
模 的 开发 现场 ， 用 邮件 进行 任务 管理 也 不 是 不 可 能 的 。 

但 是 随 着 项 目 涉及 的 人 数 和 任务 数量 的 增加 ， 这 样 的 管理 手法 就 会 
出 现 问 题 。 用 纸 来 管理 既 影响 开发 速度 又 不 适合 在 多 人 之 间 共 享 信息 。 

可 能 有 人 认为 用 Excel 进行 管理 应 该 还 是 可 行 的 “， 但 因为 Excel 自 
身 并 不 是 专门 的 问题 管理 工具 ， 所 以 在 稳定 性 等 方面 存在 问题 。 用 
Excel 制作 问题 管理 表 ， 并 将 其 存放 在 共享 目录 中 进行 管理 ， 多 人 同时 
遍 辑 后 文件 就 损坏 了 ， 这 样 的 经 历 相 信 大 家 都 有 过 吧 ”。 

还 有 一 些 开发 现场 使 用 的 是 Microsoft Project”。 该 产品 适用 于 项 目 经 
理 从 高 层次 的 视角 向 利益 相关 者 汇报 项 目的 情况 ， 并 不 太 适 合 现 场 的 作 
业 管理 。 和 Excel 相同 ， 在 多 人 同时 编辑 时 稳定 性 方面 存在 问题 。 除 此 
之 外 ， 纸 、 邮 件 、Excel 等 还 有 其 他 欠缺 的 地 方 ， 那 就 是 信息 的 统一 管 
理 和 检索 。 

对 于 后 来 加 入 项 目 或 团队 的 成 员 来 说 ， 过 去 的 事情 以 及 需求 等 信息 
统一 记录 在 一 处 ， 并 且 能 够 进行 检索 是 非常 重要 的 。 如 果 能 够 做 到 这 一 
点 的 话 ， 之 后 加 入 的 成 员 就 能 够 进行 自学 ， 加 快 追 赶 的 速度 。 最 终 项 目 
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四 ”实际 上 设法 用 Excel 进行 管理 的 开发 现场 不 在 少数 。 
@ 无 法 用 邮件 进行 管理 的 原因 在 第 2 章 说 明 过 了 ， 这 里 就 不 再 提 了 。 
@ 微软 开发 的 项 目 管理 软件 程序 。 
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的 成 功率 也 会 相应 地 上 升 。 

多 数 的 缺陷 管理 系统 都 附带 有 Wiki 的 机 制 ， 该 机 制 能 够 在 信息 共 
享 方面 起 到 作用 。 例 如 使 用 问题 票 对 课题 进行 调查 和 交流 ， 最 后 把 调查 
获得 的 知识 以 及 确定 下 来 的 需求 等 总 结 记录 在 Wiki 中 。 这 样 做 能 够 提 
高 信息 的 精确 度 ， 提 高 项 目 和 团队 的 工作 效率 。 












































4.1.3 ”导入 缺陷 管理 系统 的 优点 








可 能 和 之 前 的 说 明 有 所 重复 ， 这 里 让 我 们 从 软件 开发 项 目 这 一 大 音 
景 出 发 ， 再 来 确认 下 导入 缺陷 管理 系统 的 优点 。 





e…… 具有 任务 管理 所 需 的 基本 功能 
缺陷 管理 系统 的 显著 优点 是 具备 下 列 这 些 功能 。 





























e“ 必 须要 做 什么 ”这 样 的 任务 定义 

e“ 谁 来 做 ”这 样 的 职责 分 配 

e“ 什 么 时 候 完成 ”这 样 的 期 限 管理 

e“ 现 在 正 处 于 作业 中 还 是 已 经 完成 了 ”这 样 的 状态 管理 


另外 ， 作 为 项 目 中 专门 的 任务 管理 程序 ， 多 数 缺 陷 管 理 系统 都 是 以 
多 人 使 用 为 前 提 进 行 设计 的 ， 因 此 高 稳定 性 及 高 可 靠 性 也 是 其 主要 的 优 
点 之 一 。 











e@……. 直观 性 、 检 索性 较 强 


在 管理 复杂 项 目的 过 程 中 ， 将 项 目 中 的 问题 、 任 务 列 表 以 各 种 形式 
显示 出 来 是 非常 重要 的 。 另 外 ， 能 够 检索 找到 过 去 的 各 类 处 理 记录 也 是 
非常 重要 的 。 





@…… 能够 对 信息 进行 统一 管理 及 共享 


过 去 的 处 理 记 录 、 从 中 获得 的 知识 ， 以 及 项 目的 需求 等 对 于 项 目 来 
说 都 是 非常 重要 的 信息 ， 将 这 些 信 息 统一 管理 并 共享 是 非常 重要 的 。 这 
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些 功 能 加 上 之 前 提 到 的 高 检索 性 ， 使 得 缺陷 管理 系统 超越 了 单纯 的 任务 
管理 系统 的 范畴 ， 还 具备 了 知识 数据 库 的 特性 。 


e-…… 能够 生成 各 类 报表 


统一 管理 数据 所 带 来 的 显著 优点 之 一 就 是 易于 生成 各 类 报表 。 例 如 
每 周 生 成 的 在 进度 会 议 上 要 使 用 的 工作 完成 情况 报告 、 能 够 一 目 了 然 地 
掌握 团队 状态 的 燃 尽 图 ， 以 及 向 顾客 说 明 时 使 用 的 甘 特 图 等 ， 缺 陷 管理 
系统 能 够 方便 地 生成 各 式 各 样 的 报表 。 

能 够 以 怎样 的 程度 生成 怎样 的 报表 ， 这 方面 不 同 的 缺陷 管理 系统 会 
有 所 差异 。 有 些 是 作为 系统 的 基本 功能 提供 的 ， 有些 是 以 插件 的 形式 提 
供 的 。 大 多 数 的 系统 都 提供 了 数据 下 载 功 能 ， 如 果 没 有 符合 需求 的 报 
表 ， 可 以 下 载 数 据 后 使 用 电子 表格 等 软件 自己 生成 报表 。 如 果 系 统 提供 
了 API 或 插件 系统 ， 还 能 够 用 其 来 自由 地 开发 报表 功能 ， 这 部 分 内 容 稍 
吾 会 详细 介绍 。 

随 着 团队 开发 的 推进 ， 需 要 报表 的 情况 会 越 来 越 多 。 强 大 的 报表 功 
能 就 意味 着 制作 报表 所 用 的 时 间 能 大 大 减少 ， 这 也 是 导入 缺陷 管理 系统 
的 显著 优点 之 一 。 









































































































































@…… 能 够 和 其 他 系统 进行 关联 ， 具 有 可 扩展 性 


特别 想 强 调 的 就 是 这 一 点 。 随 着 缺陷 管理 系统 和 版 本 管理 系统 以 及 
持续 集成 ( Continuous Integration，CI ) 系统 之 间 的 关联 的 逐渐 深入 ， 从 
问题 的 发 生 到 代码 的 修改 内 容 、 测 试 结果、 发 布 情况 等 所 有 的 内 容 都 可 
以 相关 联 地 进行 管理 。 

通过 使 用 该 功能 ， 就 可 以 从 版 本 管理 系统 的 提交 记录 追溯 到 原本 的 
问题 票 ， 确 认 原 本 的 修改 理由 ， 或 者 倒 过 来 检索 过 去 的 问题 找到 对 应 的 
问题 票 ， 青 从 问题 票 找 出 相关 联 的 提交 和 测试 结果 ， 以 了 解 该 问题 是 如 
何 解 决 的 。 这 样 就 能 够 追溯 到 项 目 内 的 活动 的 各 个 方面 ， 使 得 可 追溯 性 
有 飞跃 性 的 提高 。 具 体 方法 将 稍 后 叙述 。 

具备 和 外 部 系统 关联 的 可 扩展 性 也 是 导入 缺陷 管理 系统 的 显著 优 
点 。 大 部 分 的 缺陷 管理 系统 都 具备 插件 功能 或 者 能 够 从 外 部 操控 问题 票 
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的 API 接口 ， 因 此 能 够 满足 项 目的 各 种 需求 。 


4.1.4 什么 是 缺陷 驱动 开发 


使 用 缺陷 管理 系统 ， 以 问题 票 ( ticket ) 为 中 心 构建 开发 流程 的 方法 
论 称 为 缺陷 驱动 开发 (TiDD )。 这 个 名 字 是 仿照 测试 驱动 开发 TDD 
( Test Driven Development ) 这 一 敏捷 开发 的 方法 而 取 的 。 

实践 缺陷 驱动 开发 的 规则 原则 上 只 有 一 条 ， 那 就 是 “禁止 没有 问题 
票 的 提交 ”。 提 交 记 录 和 问题 票 必 须 一 对 一 地 进行 管理 ， 以 此 来 明确 代 
码 修改 的 理由 ， 这 便 是 缺陷 驱动 开发 的 目的 所 在 。 















































e-…… 缺陷 驱动 开发 的 具体 步 又 


缺陷 驱动 开发 每 次 都 是 以 在 新 功能 开发 和 bug 修正 时 新 建 记 有 内 容 
和 目的 的 问题 票 开始 的 。 

其 次 是 根据 问题 票 的 内 容 对 代码 进行 修正 并 提交 。 这 时 在 提交 记录 
中 记 下 问题 票 号 是 非常 重要 的 ， 同 时 还 要 在 问题 票 中 记录 下 提交 记录 
号 。 这 样 问 题 票 和 代码 修正 提交 之 间 的 相互 关系 就 建立 起 来 了 ， 明 确 了 
代码 的 修改 理由 ， 日 后 进行 问题 调查 也 变 得 容易 了 。 

缺陷 驱动 开发 是 方法 论 ， 对 工具 的 使 用 并 不 是 必需 的 。 如 果 只 是 关 
联 提交 记录 和 问题 票 的 话 ， 手 动作 业 也 是 可 行 的。 实际 上 手工 关联 提交 
记录 和 问题 票 的 开发 现场 并 不 在 少数 。 
虽说 如 此 ， 但 如 果 能 够 合理 使 用 缺陷 管理 系统 的 话 ， 关 联 作 业 也 可 
以 实现 自动 化 。 这 样 就 能 避免 操作 遗漏 ， 准 确 地 关联 提交 记录 和 问题 
票 ， 进 而 促进 项 目的 可 视 化 。 

从 下 市 开始 将 主要 介绍 缺陷 管理 系统 ， 说 明 其 同 版 本 管理 系统 关联 
的 方法 。 男 外 ， 应 该 和 缺陷 管理 系统 关联 的 并 不 仅 限于 版 本 管理 系统 。 
在 和 提交 相关 联 并 实行 CI 的 情况 下 ，CI 的 结果 也 要 记录 到 问题 票 中 ， 
以 方便 日 后 调查 。 因 此 还 会 讲解 和 CI 系统 关联 的 相关 内 容 。 
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一 专栏 ”彻底 贯彻 缺陷 驱动 开发 的 情况 
上 文中 提 到 了 在 缺陷 驱动 开发 的 实践 中 工具 的 使 用 并 不 是 必需 
的 ， 手 工 关 联 问题 票 和 提交 也 是 可 行 的 。 话 虽 如 此 ， 手 动作 业 的 话 
容易 发 生 问 题 票 和 提交 之 间 的 关联 遗漏 。 
要 想 彻底 贯彻 缺陷 驱动 开发 ， 可 以 使 用 版 本 管理 系统 提供 的 客 
户 端 挂 钧 ( client side hook ) 和 服务 器 端 挂钩 ( server side hook )。 
在 上 述 挂钩 中 能 够 检查 提交 信息 中 是 否 包含 问题 票 号 ， 如 果 不 包含 
的 话 则 拒绝 接受 该 提交 ( 或 Push )。 
这 样 就 可 以 系统 性 地 保证 问题 票 和 提交 之 间 的 关联 ， 原 因 不 明 的 
修改 将 无 法 提交 到 代码 库 ， 项 目 也 就 更 安全 了 。 并 且 之 后 回顾 修改 时 
也 一 定 能 找到 作为 修改 原因 的 问题 票 ， 这 点 在 管理 上 非常 有 优势 。 
是 在 管理 方面 的 优势 有 所 增加 的 同时 ， 反 过 来 开发 的 速度 就 
可 能 受到 影响 。 这 方面 需要 权衡 考虑 ， 要 根据 项 目的 目的 和 状况 ji 
行 平衡 。 
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4.2 主要 的 缺陷 管理 系统 


缺陷 管理 系统 "包括 OSS ( Open Source Software ) 以 及 商用 软件 在 
内 ， 有 很 多 可 供 选 择 的 产品 。 这 里 将 介绍 一 些 具有 代表 性 的 产品 ”。 

















4.2.1 OSS 产品 





Trac 是 基于 Python 的 缺陷 管理 系统 ( 图 4.1 )。 它 导入 简单 ， 印 象 
中 过 去 几乎 所 有 的 开源 项 目 都 使 用 Trac， 之 后 被 后 来 的 Redmine 以 及 
SaaS ( Software as a Service ) 形式 的 GitHub 和 PivotalTracker 等 逐渐 取 
代 ， 最 近 已 经 很 少 看 到 了 。 但 如 果 要 说 上 手 简单 的 话 ，Trac 至 今 依然 是 


第 一 选择 。 


























4.1 Trac 


Integrated AC Project Management 





童 看 任务 单 新 建 任务 单 搜索 


wi WikiStart 起 始 页 索引 “历史 


Welcome to the Trac Open Source Project. 


Trac is an enhanced wiki and issue tracking system for software development projects. Trac uses a 
minimalistic approach to web-based software project management. Our mission is to help developers 
write great software while staying out of the way. Trac should impose as little as possible on a team's 
established development process and policies. 


Try out our demos! 
for Trac 0.12 (old), 
Trac 1.0 (current), 

It provides an interface to > Subversion and cy Git (or other version control systems), an integrated or Trac 1,1.x (devel) 

Wiki and convenient reporting facilities. 











也 可 以 称 为 bug 管理 系统 或 问题 管理 系统 。 

产品 的 具体 功能 请 参考 相关 资料 。 特 别 是 商用 产品 ， 因 为 其 价格 、 服 务 形式 以 及 
提供 的 功能 等 可 能 发 生变 化 ， 所 以 请 一 定 要 参考 供应 商 提 供 的 信息 
http://trac.edgewall.org/ 


OO 
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Trac 能 够 和 bug 管理 及 代码 管理 相关 联 ， 具 备 基于 Wiki 的 信息 共 
享 等 项 目 所 需要 的 功能 ， 还 可 以 通过 插件 进行 各 类 扩展 。 

Trac 已 经 有 了 日 语 版 的 安装 包 。 日 本 的 开源 社区 也 相当 活跃 ， 还 出 
版 了 相关 的 书籍 特别 是 由 志愿 者 提供 的 Trac Lightning 在 日 语 版 Trac 
的 基础 上 还 加 入 了 Subversion 和 Jenkins， 将 它们 合并 成 一 个 安装 文件 ， 
初次 使 用 时 非常 方便 。Trac Lightning 是 Windows 平台 的 安装 包 ，Linux 
平台 的 话 可 以 使 用 由 相同 人 员 开 发 的 Kanon 。 

Trac 原本 是 作为 程序 员 的 bug 管理 系统 而 开发 的 ， 因 此 用 户 界面 比 
较 简 陋 。 如 果 团 队 中 有 程序 员 以 外 的 成 员 ，Trac 那 过 于 简陋 的 接口 就 可 
能 成 为 导入 Trac 的 障碍 。 

































































@… Redmine 


Redmine" 是 比 Trac 稍 晚 的 基于 Ruby on Rails 框架 的 缺陷 管理 系 
统 (图 4.2)。 因此 ,使 用 Ruby on Rails 的 项 目 导 入 Redmine 的 门槛 会 
比较 低 。 

Redmine 同样 具备 了 bug 管理 、 代 码 管理 、Wiki 等 必要 的 功能 ， 文 
持 插件 系统 ， 扩 展 也 比较 容易 。UI ( User Interface ) 方面 要 比 Trac 更 为 
易 用 、 漂 亮 ， 非 程序 员 使 用 起 来 也 基本 上 没有 障碍 。 

Redmine 的 日 语 开源 社区 规模 大 、 非 常 活跃 ”, 而 且 还 出 版 了 很 多 相 
关 的 书籍 “。 现 在 已 经 取代 Trac， 成 为 项 目 现场 常用 的 缺陷 管理 系统 。 


















































© 


就 中 国 国内 的 情况 来 看 ， 目 前 好 像 还 没有 什么 活跃 的 社区 或 相关 书籍 。 只 有 Trac 
的 0.12 版 支持 中 文 显示 。 译 者 注 
http://sourceforge.jp/projects/traclight/ 





http://kanon.ultimania.org/ 
http://www.redmine.org/ 


http://redmine.jp/ 


QAG@OQOO 


http://redmine.jp/ 
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tH 四 


4.2 Redmine 


主页 项 目 帮助 


Redmine 


概述 轩 blob 和 


概述 


Redmine is a flexible project management web application written 学 成 员 
using Ruby on Rails framework. 





Administrator: Jean-Philippe Lang 


园 问题 跟踪 Contributor: Chaoqun Zou, Daniel Felix, Etienne Massip, Filou 
Centrinov, Go MAEDA, Jan from Planio www.plan.io, Jan 
e Defect: 1222 打开 / 6859 Niggemann (redmine.org team member), Jean-Baptiste Barth, 
® Feature: 2840 打开 / 5390 Jim Mulholland, Jonas De Meulenaere, Karl Heinz Marbaise, Lucile 
se patch: 416 打开 / 1980 Quirion, Martin Denizet (redmine.org team member), Maxim 


Krusina, Mischa The Evil, Toshi MARUYAMA 
查看 所 有 问题 
人 允 最 近 的 新 闻 


Redmine 3.0.1 and 2.6.3 (2 条 评论 ) 
由 Jean-Philippe Lang 在 3 天 之 前 添加 


Redmine 3.0.0 and 2.6.2 released (8 条 评论 ) 
由 Jean-Philippe Lang 在 28 天 之 前 添加 


Redmine 2.6.1 released (5 条 评论 ) 
出 Jean-Philippe Lang 在 2 个 月 之 前 添加 


Redmine 2.6.0, 2.5.3 and 2.4.7 released (12 条 评论 ) 
记 Jean-Philippe Lang 在 5 个 月 之 前 添加 


Redmine 2.5.2 and 2.4.6 released (6 条 评论 ) 
由 Jean-Philippe Lang 在 9 个 月 之 前 添加 


查看 所 有 新 闻 











@.……. Bugzilla 


Bugzilla 是 基于 Perl 的 缺陷 管理 系统 ( 图 4.3 )。 原 本 是 Netscape 公 
司 内 部 的 系统 ， 后 来 被 作为 0SS 公开。 现在 由 Mozilla 基金 会 继续 开 
发 ， 可 以 说 是 OSS 界 最 具 “ 历 史 和 传统 ”性 质 的 缺陷 管理 系统 。 


4.3 ”Bugzila 


























名 ， rch buorin orgr 有 5 
TiE 
About News Docs Support  _ Download Features Contribute! 
FS Bugzilla 
Who Uses Bugzilla? Bugzilla is server software designed to help you manage software development. 
Roadmap More about Bugzilla » 
Meet the Team News 


Release Information 
» Release of Bugzilla 4.4 and 4.2.6 [ 2013 May 22 ] 

* Release of Bugzilla 4.4rc2, 4.2.5, 4.0.10 and 3.6.13 [ 2013 Feb 19 ] 
Planet Bugzilla » Release of Bugzilla 4.4rc1, 4.2.4, 4.0.9 and 3.6.12 [ 2012 Nov 13 ] 
Security Advisories 





More news > 








chanaa 1 








OD http://www.bugzilla.org/ 
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至 今 Mozilla (Firefox )、Linux 内 核 、Java 的 IDE (Integrated 
Development Environment， 集 成 开发 环境 ) Eclipse" 等 历史 较 长 的 OSS 
项 日 都 使 用 Bugzilla 作为 缺陷 管理 系统 。 

Bugzilla 有 着 数量 众多 的 插件 ， 是 一 款 经 得 起 实际 使 用 的 优秀 系统 。 
但 UI 较 老 ,习惯 了 现代 Web 程序 的 用 户 可 能 用 起 来 比较 吃力 。 虽 然 几 
乎 没有 新 项 目的 开发 现场 会 选用 Bugzilla， 但 至 今 仍 有 相当 多 的 现场 还 
在 使 用 Bugzilla, 今后 也 会 继续 使 用 下 去 。 




















Mantis” 是 基于 PHP 的 缺陷 管理 系统 (图 4.4 )。 由 日 本 人 开发 ， 过 
去 在 日 本 曾 被 广泛 使 用 ,但 近年 来 几乎 看 不 到 了 。 新 项 目 一 般 不 会 使 用 
Mantis， 但 在 参加 历史 较 久 的 项 目 时 ,还 是 有 机 会 看 到 Mantis 的 。 


图 4.4 Mantis 



































® 
MAanNII 
BUG TRACKER 


Home Bugtracker Blog Phone Download Docs Demo Hosting Support Sponsors Development ContactUs 


MantisBT is a free popular web-based bugtracking system (feature list). lt is written in 
the PHP scripting language and works with MySQL, MS SQL, and PostgreSQL databases 
and a webserver. MantisBT has been installed on Windows, Linux, Mac OS, 0S/2, and 
others. Almost any web browser should be able to function as a client. lt is released 
under the terms of the CNU General Public License (GPL). 


Featuring MantisTouch for iPhone, Android and Windows Phone 








人 mantisbt © || aaa supporttor the builtin soap ext.. 


a 14871, api soap, assigned, rombert. Oh 
Paseword Project view status 
[mer | om | 有 


Provide a simple APIfor outputting ... 
14869, other resolved, rombert, 17 au 


一 一 





CopyrigM © Victor Boctee - 2012 



































OD nhttp:/www.eclipse.org/ 
© http:/www.mantisbt.org/ 
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4.2.2 ”商用 产品 











JIRA "是 由 Atlassian 有 偿 提 供 的 基于 Java 的 缺陷 管理 系统 (图 
4.5 )。 虽 说 是 商用 的 ， 但 有 30 天 的 免费 试用 期 。 该 产品 可 以 以 安装 文件 


或 Saasg 的 形式 提供 ， 功 能 丰富 。 如 果 项 目 预算 允许 的 话 ， 可 以 考虑 使 
用 JIRA。 























图 4.5 JIRA 
XJIRA Overview Pricing What's New 


Plan, track, work — 
smarter and faster 


JIRA is the project tracker for teams planning, 
building, and launching great products. 


Thousands of teams choose JIRA to capture 
and organize issues, assign work, and follow 
team activity. At their desks, or on the go with 
the new mobile interface, JIRA helps teams get 


the job done. 





SoyPoms =§ 





Aceavy 
人 comments WorkLog Hoy 














从 bug 的 管理 到 需求 的 管理 ，JIRA 能 够 以 不 同 的 粒度 管理 问题 票 ， 
还 可 以 和 版 本 管理 系统 进行 关联 。JIRA 拥有 大 量 的 插件 ， 能 够 满足 各 
类 需求 。JIRA 同样 支持 日 语 “。 但 是 Wiki 功能 由 同属 于 Atlassian 的 其 他 
产品 Confluence 来 提供 ， 这 点 需要 注意 。 


















































https://www.atlassian.com/software/jira/ 

https://www.atlassian.com/ 

JIRA 本 身 不 支持 中 文 ， 但 有 收费 的 第 三 方 汉化 插件 http://www.confluence.cn/pages/ 
viewpage.action?pageld=2164040。 译 者 注 

@ https:/www.atlassian.com/software/confluence/ 
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@… YouTRACK 


YouTRACK" 是 以 IntelliJ IDEA 等 IDE 出 名 的 JerBrains “所 提供 的 基 

于 Java 的 缺陷 管理 系统 (图 4.6 )。 这 也 是 一 款 收 费 软件 ,但 10 个 用 户 

之 内 的 可 以 免费 使 用 。 提 供 安 装 文件 和 Saag 两 种 形式 。 但 需要 注意 的 
是 该 软件 还 没有 中 文 版 本 。 


4.6 YouTRACK 





| Enalish | Deutsch | 


1 youTRACK 


Overview What's New “Features “Resources “Download& Sign up ”Buy&Upgrade 













。 。 。 。 
The Agile Issue Tracking and Project Tracking Tool 
[oi YouTRACK IssueList (~| AgileBoard 
* 
2- | 四 S| se 器 = | 
Projects " 
Kanban Sample 全 窗 © SCcS-80276 Quickly Add Contact Today 
Scrum Sample 45 
六 © SCS-80230 Set PreferredCustomer Discount Yesterday 
Tags 上 2 \ 
=[L | 站 © SCS-14131 Checkl Gprners alance and change the status 0 Yesterday 上 
他 (1 - > Cy o 
Saved Searches (10) 让 加 scs-14084 pesen > September 9 
四 Assigned to me 0 
四 Commented by me 0 窗 M SCS-14081 Create Preferred Customer September 9 
四 Customer ManagementE 0 本 和 
加 kanban 2 Baddog 0 军 M SCS-14079 Design EmailTemplate September 1 
2] Kanban sample Backog 20 N SCS-110 Check duplicates August 29 
Kanban Sample ProjectE 0 
i i N SCS-102 Design Dashboard Page August 17 
网 SqumPrledsompsBs 0 辐 容 国 ‘scs37 Export Rules Nagiist 16 
一 -一 -一 一 人 = = 











Oe Pivotal Tracker 





Pivotal Tracker 是 PivotalLab 提供 的 缺陷 管理 系统 ( 图 4.7 )。 特别 适 
合 于 敏捷 开发 的 Scrum 开发 流程 。 只 提供 Saag 形式 的 产品 。 








D http:/www.jetbrains.com/youtrack/ 
©® http:/www.jetbrains.com/ 
® http:/www.pivotaltracker.com/ 
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图 4.7 Pivotal Tracker 









PIVOTALTRACKER PRouEcrs 。 DASHBOARD REPORTS HELP 。 TAKAFuwkEnA 
My Sample Project "velocly8 
CURRENT BACKLOG IcEBOX EpcS MORE™ | PhouEcr sromIEs™ Q 
CURRENT BACKLOG 
























a i Ce EE EE EE » es Product browsing pagination not 
》 育 。 shopping Shopper should be able to click ona 》 育 中 search shopplng Shopper should be able | Start | Mong in ee 
product and see all product details, including to search for product y 高 = iniegrale wihauiomatedorderilll .= 
ed py Inital demo to Investors oe 
> 请。 cartshopping Shopper should be able to add 有 Fas Dé。 | 3 eple natveiPhone appioallowproduct 
productto shopping cart able to enter oredit card information and A 
上 言 = 口 can shopping Shopper shoud EEC shipping address 人 请 3 Facebookapp, allowingusersioshare _ ,sa 
We er ois al ， 人 neckout shopping Integrate with payment| Start and Pio 
shopping cart Oe 2 
Parstooping Shopperahoud EVE |||» 3 crocron nonos acuanion, amp Wnon EE [ 
East ac shopper submits order authorize total 
opping on product amount from payment gateway 
* 友 -。 can shopra Cartmanipuiationshoud TE | | chocron, soooina tsysomiaiso [i 
MAY authorize payment amount, display error 
本。 anoppmg Someproductphotosnotscaled EE message to shopper 
ono me 请 。 checkout, shopplng Ifauthorizatonis | Start 
> 请 ,中 shopplng Shoppershouldbeableto | Stat | 王 successful, show order number and 
recommend a productto a fiend ‘confirmation message to shopper 
se eoriove rte hie connn | ai 
2 > 请。 admin checkout shopplng Send notifica | Start 
‘tion email of order placement to admin 
请 = orders Shoppershouldbeabletocheck | Start | 门 
status of order by entering name and 
‘order number 
»》 育 中 orders Shoppershouldbeabletoask | Stat | 站 
auestion ahoutorder 




















作为 Web 应 用 程序 Pivotal Tracker 非常 有 趣 ， 并 且 能 够 通过 拖 忠 直 
观 地 新 建 、 移 动 问题 票 。 多 人 同时 编辑 时 能 够 在 画面 上 实时 地 反映 出 
来 。UI 界面 也 易于 使 用 。 但 是 需要 注意 Pivotal Tracker 没有 中 文 版 本 。 

如 果 团 队 成 员 习 惯 于 Scrum 的 话 ，Pivotal Tracker 是 非常 方便 日 易 
用 的 工具 。 








[TE Backlog 

















Backlog 是 由 日 本 的 nulab “提供 的 缺陷 管理 系统 (图 4.8 )。 支 持 
SaaS 和 安装 文件 两 种 形式 。 因 为 是 日 本 公司 的 产品 ， 所 以 对 日 语 的 支持 
方面 完全 没有 问题 ， 当 然 也 支持 多 语言 ， 包 括 中 文 “。 





OD http:/www.backlog.jp/ 
@) http:/www.nulab.co.jp/ 
® http://backlogtool.com/cn/ 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


4.2 主要 的 缺陷 管理 系统 | 115 











4.8 Backlog 


贺 pasboard 。 页 昌 。 最 浏 览 的 误 题 最近 浏览 的 Wid 。 课 是 入选 成 员 。 查询 课题 





(9 田 队 开发 相关 技术 的 项 目 量 wo os 


个 人 设置 | 空间 设置 | 帮助 | 退出 


开始 设置 您 的 空间 吧 。 

。 沪 加 大 日 阁 添加 用 户 疾 设置 空间 微 标 

本 请 添加 成 员 至 您 的 空间 ， 请 自 定义 空间 徽标 ， 

请 在 您 的 衬 间 添 吉 二 个 项 县 现在 就 邀请 他 们 吧 。 它 将 会 昌 示 在 此 空间 页 面 的 左上 角 。 





最 近 更 新 
| a 先生 /女士 了 课题 前 
DB we 
仿 知 TRANS_TEAMWORK-2 第 4 章 : TravisCl 已 经 开始 支持 私有 的 代码 库 ， 添 加 


我 的 课题 @ 癌 查询 我 的 课 8 容 
提交 者 () 2 


KEY 标题 优先 级 状态 期 限 日 个 





团队 开发 入 门楼 详 (TRANS_TEAMWORK) 








TRANS-TEAWWORK test 课题 哆 ” 际 通 





TRANS_TEAMWORK ”第 4 章 : TravisCI 已 经 开始 支持 私 
2 有 的 代码 库 ， 添 加 相关 内 容 中 飞天 
mE = 区 2 分 钟 前 
RANS_TEAMWORK 第 3 章 前 半 部 分 哆 “车 运 2 部 分 
NE 第 3 章 后 半 部 分 中 未 处 理 























将 什么 时 候 、 谁 、 对 文件 做 了 怎样 的 修 


Backlog 能 够 与 bug 管理、 代码 管理 相关 联 ， 也 支持 Wiki 的 信息 共 
享 ， 必 要 的 功能 可 谓 一 应 俱全 。10 名 用 户 、1 个 项 目 以 内 可 以 免费 使 用 。 

Backlog 以 亲切 易 用 的 UI 以 及 可 爱 的 设计 为 特征 ， 还 可 以 使 用 表情 符 
号 ， 像 使 用 手机 一 样 发 送 表情 。 程 序 员 以 外 的 人 用 起 来 也 能 得 心 应 手 “。 














@.…. GitHub 


GitHub“ 已 经 在 第 3 章 介绍 过 了 。 作 为 缺陷 管理 系统 ，GitHub 同样 
具备 不 俗 的 功能 ( 图 4.9 )。 检 索 功 能 等 可 能 稍微 弱 了 些 ， 但 和 代码 管理 
的 交互 做 得 非常 出 色 ， 还 具备 Wiki 的 功能 。 并 且 还 有 名 为 GitHub Pages 
的 用 于 建立 项 目 网 页 的 功能 ， 以 及 类 似 于 Travis CI 的 CI 工具 。 可 以 毫 
不 夸张 地 说 ，GitHub 能 够 提供 OSS 项 目 所 需要 的 所 有 功能 。 














@ 本 书写 作 时 就 使 用 了 Backlog 的 免费 缺陷 管理 系统 ， 用 Backlog 提供 的 Git 来 管 
理 原 稿 。 
©® nhttps://github.com/ 
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4.9 GitHub 














虽 . This repository -Search ortypea command © Explore Gist Blog Help 柄 ieikedas 请 
日 playframework / playframework GUnwatch- 390 其 Unstar 3398 上 Fork 1097 
Browse lssues | Miestones [| 
《> 
re) ee | 
Created by you 0 NM Upgrade to sbt idea 1.5.1 final #1397 n 
Opened by huntc an hour ago 肝 1 commer 
Mentioning you 0 
© Ropeoe the text "Play 2" or "Play 2.1" with just "Play" #1396 hk: 
mad hour ago 
Ni lest Jected Se E 
wa 全 i read scala version from runtime ond a 
Opened by XuefengWu 4 hours ago M2 comment ts _ 
Labels 了 
© [LESS/2.1.2] LESS on taking too long #1394 
duplicate 1 Opened by srkanth7 6 hours 
Sm 4 © Keep-Alive/POST fix Play 2.0.3 #1393 
Ql needs-verification 4 Opensad by pot 但 bun 
9 Nn update javaGuide3.md - ere onApplicationStart method name to onStart #1392 
6 Opened by richardbroersma 16 ho 肥 1comment nt 
9 门 Removing closed channels from group #1391 
nota bug 9 
wont fix 0 | © Shared dependency-free reverse router across multiple projects #1390 











问题 在 于 没有 中 文 版 本 ， 并 且 基 本 上 只 有 面向 程序 员 的 功能 ， 程 序 
员 以 外 的 项 目 成 员 使 用 起 来 可 能 有 些 困 难 。 

GitHub 虽然 可 以 免费 使 用 。 但 如 果 不 想 让 其 他 人 看 到 项 目的 内 容 的 
话 ， 就 需要 购买 私有 代码 仓库 ， 将 项 目 设置 为 和 有， 这 点 请 注意 。 第 3 
章 中 已 经 提 到 过 ，GitHub 还 提供 安装 文件 形式 的 GitHub Enterprise， 在 
公司 内 部 使 用 的 话 可 以 考虑 GitHub Enterprise。 














4.2.3 选择 工具 ( 缺陷 管理 系统 ) 的 要 点 








至 此 我 们 对 主要 的 缺陷 管理 系统 进行 了 介绍 。 无 论 是 OSS 还 是 商用 
产品 ， 数 量 都 相当 多 ， 选 择 起 来 比较 困难 。 并 且 缺 陷 管理 系统 并 不 像 版 
本 管理 系统 以 及 CI 工具 那样 有 常规 的 选项 。 

除了 上 面 介绍 的 几 款 之 外 ， 还 有 很 多 其 他 的 工具 ， 大 家 也 可 以 试 着 
挑选 适合 自己 的 开发 现场 的 工具 。 选 择 工 具 时 需要 确认 的 关键 点 因 开发 
现场 而 异 ， 但 特别 需要 注意 的 是 工具 所 提供 的 扩展 性 如 何 ， 以 及 是 否 易 
于 实现 。 

缺陷 管理 系统 和 版 本 管理 系统 以 及 CI 工具 不 同 ， 工 程 师 以 外 的 项 

目 利益 相关 者 也 会 比较 多 地 接触 到 缺陷 管理 系统 。 并 且 很 多 缺陷 管理 系 
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统 都 和 团队 的 业务 流程 密切 相关 。 因 此 ， 能 和 否 扩展 缺陷 管理 系统 ， 使 其 

















灵活 地 适应 现场 的 开发 流程 ， 这 一 点 同样 很 重要 。 





这 里 介绍 的 缺陷 管理 系统 都 支持 以 某 种 形式 进行 扩 


REST API 或 插件 机 制 等 。 











如 果 选 用 本 次 介绍 的 工具 之 外 的 ] 











展 性 。 





一 专栏 ”缺陷 管理 系统 的 应 用 事例 














展 ， 一 般 会 提供 


其 他 工具 ， 选 择 时 一 定 要 注意 其 扩 




















原本 用 














软件 开发 项 目 中 的 任务 管理 的 缺陷 管理 系统 ， 近 年 来 


















































逐渐 被 扩展 应 
例如 ， 笔 




















到 了 其 他 各 个 领域 。 
者 所 在 的 团队 就 在 下 列 业务 中 用 到 了 缺陷 管理 系统 。 





























@ 用 户 咨 
@ 委托 其 











这 是 因为 


询 的 管理 
他 部 门 的 工作 的 管理 





缺陷 管理 系统 所 具有 的 定义 任务 、 确 定 责 任 人 和 期 限 




































































这 样 的 任务 进度 管理 功能 对 几乎 所 有 的 工作 都 是 通用 的 。 





想必 本 书 
系统 能 够 在 各 


















































的 读者 基本 上 都 是 软件 开发 相关 的 工程 师 ， 缺 陷 管理 
类 业务 中 起 到 作用 ， 所 以 请 一 定 在 软件 开发 项 目 之 儿 

























































































也 试 着 应 = 下 sa 














图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 





118 | 第 4 章 缺陷 管理 


4.3 缺陷 管理 系统 与 版 本 管理 系统 的 关联 





随 着 缺陷 管理 系统 的 导入 ， 任 务 的 管理 变 得 简单 ， 项 目 也 开始 顺利 
运转 ， 接 着 应 该 着 手 的 就 是 和 版 本 管理 系统 的 关联 了 。 关 联 问题 票 和 代 
码 的 修改 能 够 使 问题 或 bug 的 调查 变 得 方便 ， 由 此 对 项 目的 管理 也 会 更 
为 得 心 应 手 。 

















4.3.1 通过 关联 实现 的 功能 





通过 关联 两 个 系统 能 够 实现 如 下 这 些 功 能 。 














e@…… 从 提交 链接 到 问题 票 


利用 这 个 功能 能 够 从 代码 的 修改 追溯 到 原本 的 问题 票 。 特 别 是 在 以 
开发 者 的 角度 来 调查 代码 的 修改 时 ， 该 功能 非常 方便 。 在 缺陷 管理 系统 
和 版 本 管理 系统 密切 整合 的 系统 中 可 以 使 用 该 功能 ， 具 体 来 说 有 Trac、 
Redmine 、Backlog 、Github 等 系统 。 

相反 ， 缺 陷 管 理 系 统 使 用 JIRA 或 Pivotal Tracker， 版 本 管理 系统 使 
用 另外 的 Git (GitHub ) 的 情况 下 ， 要 在 版 本 管理 系统 的 提交 记录 中 添 
加 缺陷 管理 系统 的 问题 票 的 链接 就 比较 困难 了 ， 这 点 请 注意 。 



































e@…… 从 问题 票 链接 到 提交 


和 上 述 功 能 相反 ， 这 是 一 个 从 问题 票 出 发 ， 追 查 做 出 了 怎样 的 修改 
的 功能 。 主 要 是 在 从 QA 负责 人 、 顾 客 或 者 和 顾客 立场 相近 的 利益 相关 
者 的 角度 出 发 ,来 确认 发 生 问题 的 始末 、 调 查 影响 范围 时 ， 该 功能 非常 
方便 。 即 使 在 缺陷 管理 和 版 本 管理 使 用 各 自 独立 的 系统 的 情况 下 ， 只 要 
进行 适当 的 配置 ， 多 数 情 况 下 还 是 能 够 使 用 该 功能 的 ， 所 以 应 该 尽量 地 
加 以 利用 。 
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@…… 提交 的 同时 修改 问题 票 的 状态 

这 是 一 个 在 向 版 本 管理 系统 进行 提交 的 同时 修改 相关 联 的 问题 票 的 
状态 的 功能 。 该 功能 能 够 使 开发 人 员 的 提交 作业 和 项 目的 工作 流程 相关 
联 ， 帮 助 加 快 开发 速度 。 











4.3.2 ”关联 的 配置 方法 
几乎 所 有 的 缺陷 管理 系统 都 具备 和 版 本 管理 系统 相关 联 的 功能 ， 配 
置 的 方法 也 基本 相同 。 实 际 进行 配置 时 ， 只 要 参考 文档 或 相关 书籍 等 次 
料 ， 应 该 都 能 够 顺利 地 进行 。 
这 里 , 我们 以 使 用 Git 版 本 管理 系统 为 前 提 ”, 就 上 述 介 绍 的 缺陷 管 
理 系 统 之 中 的 一 些 主要 产品 的 配置 方法 进行 简单 的 说 明 。 






































4.3.3 GitHub 





i GitHub 的 issue 


关联 GitHub 自 带 的 issue 功能 和 代码 修改 是 非常 简单 的 ， 只 需 在 提 

交 记 录 中 像 下 面 这 样 加 入 issue 的 号 码 即 可 。 
Fixed #21 

这 样 从 提交 到 21 号 issue 的 链接 就 建立 起 来 了 。GitHub 还 会 在 21 
号 的 issue 中 添加 相应 的 提交 记录 的 链接 ， 并 把 其 状态 修改 为 close。 可 
以 说 必要 的 功能 是 一 应 俱全 的 。 

像 这 样 ，GitHub 较 好 地 具备 了 关联 缺陷 管理 系统 和 版 本 管理 系统 的 
功能 。 就 这 样 运用 GitHub 应 该 也 没有 什么 太 大 的 问题 ， 只 是 很 多 开发 
队 已 经 在 使 用 其 他 缺陷 管理 系统 。 另 外 ， 因 为 需要 使 用 GitHub 所 不 
具备 的 报表 生成 功能 而 另行 选用 其 他 缺陷 管理 系统 的 团队 也 不 在 少数 。 

在 这 样 的 情况 下 ， 可 以 将 GitHub 彻底 地 作为 版 本 管理 系统 来 使 用 ， 

































































中 关于 Subversion 和 缺陷 管理 系统 的 关联 方法 ， 请 参考 文档 、 书 籍 或 网 络 资料 等 。 
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使 用 其 他 的 产品 作为 缺陷 管理 系统 。GitHub 同样 提供 这 样 的 功能 。 
@…… Service Hooks 


GitHub 为 每 个 代码 库 提供 了 和 其 他 服务 相关 联 的 机 制 (图 4.10 )， 
该 机 制 称 为 Service Hooks。 它 能 够 在 向 Git Push 代码 时 通过 Hook ( 挂 
钩 ) 和 其 他 服务 进行 信息 交互 。 在 各 代码 库 的 菜单 中 依次 选择 Settings> 
Webhooks&Services>Configure services， 就 可 以 进行 确认 。 配 置 时 需要 
该 代码 库 的 Admin 权限 ， 这 点 请 注意 。 























4.10 Service Hooks 





Options Webhooks Add webhook 
cision Webhooks allow extemal services to be notified when certain events happen on GitHub. When the specified 
events happen, we'l send a POST request to each of the URLs you provide. Leam more in our Webhooks Guide. 
Webhooks & Services 
Deploy Keys 
We also support integrations with third-party services. Looking for those? 
Services 


《 Selecta service to set up your integration 
ActiveCollab 


Backlog 




















如 图 4.10，GitHub 提供 了 志 界 上 几乎 所 有 系统 的 Hook。 从 中 找 出 
自己 所 使 用 的 缺陷 管理 系统 的 Hook 并 进行 配置 ， 这 样 就 实现 了 GitHub 
和 缺陷 管理 系统 的 关联 。 

而 万 一 没有 提供 相应 的 Hook 的 话 ， 则 有 以 下 两 个 办 法 。 

其 一 就 是 配置 Webhooks (图 4.11 )。 这 是 一 种 向 设 定 的 URL 发 送 
固定 格式 的 POST 请 求 的 通用 做 法 。 在 和 公司 内 部 独自 开发 的 系统 关联 
时 就 能 发 挥 作用 。 顺 便 说 一 下 ，GitHub 发 送 请 求 的 服务 器 的 IP 地 址 是 
公开 的 “， 所 以 在 和 公司 内 部 系统 进行 关联 时 还 可 以 使 用 IP 过滤， 消除 


D http://developer.github.com/v3/meta/ 
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安全 方面 的 隐患 。 


图 4.11 Webhooks 














Webhooks /Add new 


‘We'll send a POST request to the URL below with details of any subscribed events. You can also specify which 
data format you'd like to receive (JSON, x-www- form-urlencoded, etc). More information can be found in our 
developer documentation. 


Payload URL * Payload version 
https://example.com/postreceive application/vnd.github.v3+form v 


Which events would you like to trigger this webhook? 
@ Just the push event. 

OD Send me everything. 

© Let me select individual events 


转 Active 
We will deliver event details when this hook is triggered. 


re | 
Add webhook 














其 二 就 是 自行 开发 Service Hooks。GitHub 的 Service Hooks 是 作为 
OSS 公开 在 GitHub 上 的 “。 只 要 按照 说 明 开 发 Hook 并 公开 ,全 世界 的 工 
程 师 就 都 能 使 用 该 Service Hook。 








@…… GitHub 和 Pivotal Tracker 的 关联 





Pivotal Tracker 是 GitHub 的 Service Hooks 中 提供 Hook 的 服务 
之 

只 需要 配置 Pivotal Tracker 所 发 行 的 Token 和 对 象 Branch ( 分支 ) 
即 可 运行 (图 4.12 )。Branch 处 空白 的 话 ， 每 次 Push 修改 时 都 会 监听 所 
有 分 支 ， 并 在 相应 的 PivotalTracker 的 问题 票 中 添加 链接 。EndPoint 通 
常 可 以 为 空 ，Pivotal Tracker 的 话 只 有 在 使 用 custom domain 的 情况 下 才 
需要 配置 EndPoint。 

















中 https:/Wgithub.comygithub/github-services 
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4.12 GitHub 的 Service Hook ( Pivotal Trakcer ) 





Token 


Branch 


Endpoint 


口 Active 


Update settings 


Install Notes 

. "tokem is your Pivotal Tracker API Token. This is at the bottom of your My 
Profile' page. 

2. "branch" is the name of the branch you want to lsten for commits on. |f 

none is provided it will lsten on all branches. 

"endpoint" is an optional endpoint for a custom Pivotal Tracker installation. 

Leave this blank to use "httpsJwww,.pivotaltracker.corY . 


2 











配置 完成 后 ， 在 提交 时 添加 如 下 提交 记录 ， 则 对 应 的 问题 票 (这 里 
是 问题 票 ID123456 ) 和 修改 的 内 容 就 关联 起 来 了 。 
[#123456] 修正 了 发 送 邮 件 的 bug 
用 “[]” 将 票 号 (#+ 号 码 ) 围 起 来 。 这 时 如 果 该 问题 票 的 状态 是 
“not started” 的 话 ， 则 状态 会 自动 更 新 为 “started”。 
es iat 的 状态 设置 为 “finished”， 可 以 像 
这 样 添加 提交 记录 。 
[Fixes #123456] 修正 了 发 送 邮件 的 时 机 问题 
其 他 的 格式 可 以 参考 Pivotal Tracker 的 帮助 "。 成 功 关 联 Pivotal 
Tracker 和 GitHub 的 话 ， 如 图 4.13 所 示 ， 问 题 票 和 代码 修改 之 间 的 关联 
就 建立 起 来 了 。 









































D https:/www.pivotaltracker.com/help/api?version=v3#scm post commit message syntax 
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4.3 缺陷 管理 系统 与 版 本 管理 系统 的 关联 





图 4.13 ”建立 问题 票 和 代码 修改 之 间 的 关联 





用 
| 批量 下 载 时 的 文件 名 中 混 有 多 余 的 文字 7 | 


到 ES 4 








| LejUpJasssatszsj|wore 由 save | Close 
































STORY TYPE 请 Featurev | 
POINTS _ 1Pointv 

| | REQUESTER 康 树 奥 村 vw | 
OWNER 康 树 奥 村 v | 
BUGZILLAID 24127 加 | 


Requested 15 May 2013, B:09am | 





DESCRIPTION A 
通过 批量 下 载 下 载 的 文件 名 中 混 有 多 余 的 文字 





























LABELS 2 2 
| 
TASKS 
Add a task 4 | na | 
ACTIVITY AI Activity v 
Commit by buster84 24 May 2019, 6:27pm 
俩 [Fixed #49891579 #49891623 #49891631] Create report 
file after syncing data. 


https://github.com/Shanon/DeeElle/commit 
/201aa967f01653c6f2a8e3c836e3f455541524ba 











@…… GitHub 和 JIRA 的 关联 














JIRA 也 和 Pivotal Tracker 一 样 ，GitHub 在 Service Hooks 中 提供 了 
相应 的 Hook。 只 需 输 入 必要 的 信息 ， 就 能 和 GitHub 进行 关联 。 

提交 时 输入 如 下 提交 记录 即 可 。JIRA 的 情况 下 ，C00LAPP-123456 
这 部 分 是 对 应 的 问题 票 号 。 

[#C00LAPP-123456] 修正 了 发 送 邮件 的 bug 

使 用 Service Hooks 的 关联 是 以 代码 库 为 单位 进行 配置 的 ， 所 以 每 
增加 1 个 代码 库 都 必须 对 其 进行 配置 。 如 果 觉 得 麻烦 的 话 可 以 用 一 些 灵 
活 的 方法 来 应 对 ， 例 如 用 JIRA DVCS Connector Plugin" 对 GitHub 









































中 https://marketplace.atlassian.com/plugins/com.atlassian.jira.plugins.jira-bitbucket- 


connector-plugin 
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Organization 进行 统一 配置 等 。 各 位 可 以 试 着 使 用 这 些 功 能 。 


4.3.4 Trac/Redmine 





在 Subversion 还 是 主流 的 版 本 管理 系统 的 时 代 ， 比 较 多 见 的 是 使 用 
Trac 或 者 Redmine 对 问题 票 和 代码 进行 管理 。 那 时 一 般 是 自行 在 服务 器 
上 建立 Subversion 的 代码 库 ， 将 Trac 或 Redmine 设置 为 代码 库 的 浏览 
器 ， 再 配置 相互 之 间 的 关联 。 

但 自从 GitHub 出 现 后 ，Git 的 简洁 以 及 GitHub 的 Pull Request 的 便 
利 开 始 逐 渐 为 人 所 知 并 得 到 普及 ， 现 在 已 经 没有 太 大 的 必要 特意 自行 构 
建 Git 仓库 ， 并 使 用 Trac 或 Redmine 作为 代码 库 的 浏览 融 了 。 坦 率 地 说 ， 
如 今 使 用 GitHub 的 费用 也 已 经 比较 合理 了 。 完 全 可 以 用 GitHub 作为 代码 
库 浏览 器 ， 而 将 Trac 或 Redmine 作为 纯粹 的 缺陷 管理 系统 来 使 用 。 

GitHub 的 Service Hooks 中 已 经 提供 了 Trac 和 Redmine 的 服务 ， 请 
加 以 有 效 使 用 。 















































4.3.5 Backlog 





Backlog 原本 是 作为 提供 类 似 于 Trac 和 Redmine 的 功能 的 SaaS 开 
始 开发 的 。 sa Subversion， 和 Trac 和 Redmine 一 样 可 以 作为 
代码 库 浏 览 器 来 使 用 ， 问 题 票 和 代码 修改 的 关联 容易 。 

Backlog we。 Git 了 。 在 线 托管 Git 的 SaaS 除了 GitHub 
之 外 并 不 多 , 日 本 国内 比较 有 名 的 也 就 只 有 Backlog 了 。 使 用 Git 作为 
版 本 管理 系统 的 话 ，GitHub 在 大 多 数 情况 下 都 是 最 好 的 选择 。 但 考虑 到 
项 目的 差异 以 及 预算 ，Backlog 也 是 非常 有 竞争 力 的 选项 。 

并 且 ，GitHub 的 Service Hooks 中 公开 有 Backlog 服务 ， 所 以 可 以 
采用 这 样 的 方法 : 将 Backlog 作为 纯粹 的 缺陷 管理 系统 来 使 用 ， 版 本 管 
理 系 统 则 使 用 GitHub。 
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@…… Backlog 和 Git 的 关联 


关联 Backlog 和 Git 的 配置 比较 简单 。 可 以 分 别 为 每 一 个 项 目 进行 
配置 (图 4.14)。 只 需要 在 各 项 目的 “项 目 设 置 >Git> 设置 ”中 选中 
“连接 课题 和 关键 字 ” 即 可 。 


4.14 ”关联 Backlog 和 Git 的 配置 


























项 目 设置 
编辑 项 目 ( 关 假如 您 不 是 此 项 目 成 员 ， 某 些 功能 链接 将 失效 。 ) 
对 项 目 设置 
i ? 
编辑 项 目的 基本 设置 Gi 回 
成 员 Repositories 设置 
主题 
种 类 连接 课题 和 关键 字 
类 别 提交 信息 将 作为 相关 课题 的 新 评论 ， 若 含有 某 些 关键 字 (如 : #closes,#ixes 等 ) ， 课 题 的 状态 
将 自动 更 新 。 
版 本 / 
里 程 碑 
Subversion | 提交 | 
| Git 











配置 完成 后 ， 在 提交 记录 中 输入 如 下 内 容 即 可 进行 关联 。 


TEAMDEV-31 
缺陷 管理 功能 和 版 本 管理 的 关联 方法 。 未 完 ， 这 部 分 结束 后 前 半 部 分 结束 。 


如 图 4.15 所 示 ， 问 题 票 和 代码 修改 关联 起 来 了 。 并 且 ， 从 代码 到 问 
题 票 的 链接 也 如 图 4.16 这 样 建立 起 来 了 。 


4.15 ”关联 问题 票 和 代码 修改 


约 30 页 


























显示 全 部 ， 只 显示 注释 


发 展开 全 部 
5 评论 
2013/07/15 20:39 负 ikeda_t 期 限 日 : 2013106/30 -> 2013/07/21 
2013/07/28 20:39 kedar A | 引用 | 编辑 | 删除 会 
o 提交 : 166f67e59f 
TEAMDEV-31 写 了 工具 的 介绍 
2013/08/13 01:07 [ok) ikedat 认 + | 引用 | 编辑 | 删除 会 


9 提交 :55aab31b67 ”|( 向 teamdev 的 master 进行 Push ) 
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4.16 ”从 代码 到 问题 票 的 链接 














国 Repository | teamdev | 4 || 她 Tree:55aab31b67 & | | Files | Commit 历 史 














修改 55aab31b67 局 诗 





上 一 次 更 新 2013/08/13 ”01:05 ( 12 天 前 ) 
更 新 者 mY ikedar 


评论 TEAMDEV-31 
缺陷 管理 功能 和 版 本 管理 的 关联 方法 。 未 完 ， 这 部 分 结束 后 前 半 部 分 结束 。 








commit 会 影响 路 径 名 字 
个 避 ”chapter-3.md 团 显 示 差异 @ 历史 纪录 器用 浏览 器 直接 打开 F 

















@…… Backlog 和 GitHub 的 关联 


Backlog 公开 在 GitHub 的 Service Hooks 中 ， 所 以 和 GitHub 的 关联 
也 是 非常 容易 的 (图 4.17 )。 


4.17 ”GitHub 的 Service Hook ( Backlog ) 





Api Url 


User Id 


Password 








Update settings 


Backlog 


Backlog is a project management, hosting service. 
http://backlogtool.com, http:/www.backlog.jp (Japanese) 


Install Notes 
1. apl_url is a API URL. e.g. if the Space ID is example, then the api_url will be 
https//example.backiog.jp/XML-RPC or 
https://example.backlogtoo.com/XML-RPC 
2. user_id and password - user_id and password of a Backlog user that can 
post comment and update issue. 


You can specify issue keys (e.g. DORA-1) and status keywords (#fixed, 
#closed) to change issue status (Resolved, Closed). 
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4.3.6 ”Git 自 带 的 Hook 的 使 用 方法 














使 用 像 GitHub 和 Backlog 这 样 的 系统 ， 缺 陷 管 理 系 统 和 版 本 管理 系 
统 之 间 的 关联 的 确 比较 容易 。 但 因为 无 法 定制 Git 自身 ， 所 以 自由 度 和 
灵活 度 方面 还 是 受到 了 限制 。 之 前 提 到 的 系统 大 部 分 只 公开 了 Git 的 服 
务 器 端 Hook 中 的 Post-receive Hook， 并 没有 公开 所 有 的 Hook。 

自己 搭建 Git 服务 器 的 话 ， 就 能 够 使 用 Git 所 提供 的 所 有 Hook。 在 
Git 的 代码 库 的 .git/hooks/ 目录 下 ，Git 提供 了 许多 分 别 运 行 在 服务 器 端 
以 及 客户 端的 Hook。 该 目录 下 存放 有 默认 文件 名 为 *.sample 的 示例 脚 
本 ， 以 此 文件 为 样本 进行 开发 ， 可 以 写 出 各 种 各 样 的 Hook 。 



























































中 详细 内 容 请 参考 Git 的 文档 。http://git-scem.com/book/zh/ 自 定 义 -Git-Git 挂钩 。 
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4.4 新 功能 开发 、 修 改 bug 时 的 工作 流程 


缺陷 管理 系统 和 版 本 管理 系统 关联 后 ， 新 功能 











开发 /修改 bug 时 的 














工作 流程 如 下 。 本 节 以 JIRA 缺陷 管理 系统 、Git ( GitHub ) 版 本 管理 系 








统 为 例 来 进行 说 明 。 


@ 建立 问题 票 

@ 指定 责任 人 

@ 开 发 

@ 提交 

加 Push 到 代码 库 


4.4.1 工作 流程 








首先 根据 问题 内 容 建 立 


立 问题 票 ( 图 4.18 )。 





旋 评语 | 凶恶 
4.18 ”建立 问题 票 
a-techconsul | PATECHCONSUL-829 
》 邮件 没有 被 发 送 
ZE | Assign | Comment | LogWork MorAetions - (| Star Progress Resolvelssue | Workfiow~ Shae mViewe - 
Details People 
Type 国 Buo Status 者 Opan Assionee; Takafumi keda 
Priority: 全 Major Reaolution Unresolvod Reporer Takafumi lkeda 
Se er vate (0) A Watching (1) 
Labels None 
Dates 
Description 
Croated Today PM 2:09 
申请 时 本 来 应 该 发 送 的 邮件 没有 发 送 。 Updatod: Today PM 209 
mee Collaborators 中 
OWNev13-30Now13 | 4 | Curant | | Repor | 室 | 用 | | 2 LogWork 
Date Desorpion Workod Agile 
View on Board 
Activity 


A | Comments | Work Log History Actviy Ta 





There are no comments yet on this issue. 
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F 始 





为 了 实现 或 修改 功能 ， 对 代码 进行 修改 并 提交 。 这 时 要 在 提交 记录 
中 添加 问题 票 的 票 号 。 不 同 缺 陷 管 理 系 统 对 应 的 提交 记录 格式 可 能 有 所 
不 同 ，JIRA 的 提交 记录 如 下 。 


[#PATECHCONSUL - 829] 修改 了 发 送 邮件 的 bug 

















@……@ Push 到 代码 库 


在 将 提交 的 内 容 Push 到 代码 库 〈 图 4.19 ) 的 同时 ， 系 统 会 在 关联 

的 问题 票 中 添加 提交 的 链接 ( 图 4.20 )。 这 样 问题 票 和 提交 之 间 的 关联 
就 建立 起 来 了 “。 

图 4.19 代码 库 的 提交 记录 


© mn EE 


ED TechConsulting / CoolApp Unwatchr 8 二 sar 0 蕊 Fok 0 














了 panon master » CoolApp / Commits 


Nov 10, 2013 
有 #PATECHCONSUL - 829] 修改 了 发 送 邮件 的 bug 4 和 
\ red 


akalumiikeda author 





ws ago 











{2 


在 传统 的 项 目 管理 中 ， 由 项 目 经 理 来 指派 合适 的 开发 人 员 。 而 在 敏捷 开发 的 团队 
中 ， 则 是 开发 人 员 自行 建立 问题 票 ， 再 将 问题 票 指派 给 自己 。 特 别 是 采用 Scrum 
的 团队 开发 ， 问 题 票 建立 时 负责 人 一 栏 是 空白 的 ， 在 每 天 的 例会 (展会) 上 由 开 
发 人 员 自 己 举 手 认 领 问 题 票 。 
@ 在 这 个 例子 中 没有 对 提交 时 的 提交 记录 进行 检查 ， 因 此 即使 忘记 在 提交 记录 中 添 
加 问题 票 号 也 能 够 顺利 提交 。 如 果 和 希望 系统 强制 要 求 输 入 问题 票 号 的 话 ， 可 以 使 
用 版 本 管理 系统 提供 的 Hook 机 制 ， 在 提交 时 对 是 否 记 载 了 问题 票 号 进行 检查 。 
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图 4.20 ”在 问题 票 中 添加 链接 


2 pa-techconsul / PATECHCONSUL-829 
”邮件 没有 被 发 送 


2 Edit Assign Comment LogWork More Actions ~ Start Progress Resolvelssue Workflow 





7 Details 
Type: 图 Bug Status: 晶 Open 
Priority: 会 Major Resolution: Unresolved 
Component/s: None 
Labels: None 

* Description 





申请 时 本 来 应 该 发 送 的 邮件 没有 发 送 。 


~Tempo 
01/Nov/13- 30/Nov/13 ， 4 Curent Repot 三 围 2 LogWork 


Date Description Worked 


7 Activity 





Al Comments Work Log Historyy Activity Transitions Summary | Commits 
Ly| takafumi-ikeda Today PM 2.44 


[#PATECHCONSUL - 829] 修改 了 发 送 邮件 的 bug Viewfullcommit 器 


2 master 


+2 | 1 | src/main/java/com/gmail/ikeike443/App.java 














在 介绍 Pivotal Tracker 和 Backlog 时 已 经 提 到 过 ， 在 提交 记录 的 问 
题 票 号 中 插入 Fixs 、Fixed、Delivered 等 特定 的 命令 语句 的 话 ， 在 
添加 链接 的 同时 还 能 改变 问题 票 的 状态 。 命 令 语句 的 格式 以 及 与 之 对 应 
的 状态 变化 ， 各 个 缺陷 管理 系统 不 尽 相 同 ， 请 参考 相应 的 帮助 文档 。 
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4.5 回答 “那个 bug 是 什么 时 候 修正 的 ”的 问题 





团队 开发 过 程 中 经 常会 从 销售 、 顾 问 或 者 客户 那里 收 到 “ 那 时 的 那 
个 bug， 是 什么 时 候 、 在 哪个 版 本 修正 的 ?” 这 样 的 调查 要 求 。 

这 时 ， 如 果 已 经 关联 了 缺陷 管理 系统 和 版 本 管理 系统 的 话 ， 就 有 可 
能 顺利 地 找 出 答案 。 

















4.5.1 Pivotal Tracker 的 例子 





首先 以 Pivotal Tracker 为 例 进 行 说 明 。 
。…… 用 记忆 中 残留 的 关键 字 进 行 检索 


如 果 在 收 到 这 样 的 调查 要 求 时 能 够 得 知 问题 票 号 ， 那 就 不 必 再 去 查 
找 问题 票 了 。 但 如 果 无 法 获得 ， 那 就 只 能 通过 调查 内 容 中 模糊 的 信息 以 
及 负责 人 模糊 的 记忆 来 找 出 问题 票 。 





首先 使 用 缺陷 管理 系统 的 检索 功能 找 出 问题 票 (图 4.21 )。 这 里 用 
关键 字 “ 一 并 下 载 ”进行 全 文 检索 。 
4.21 ”用 Pivotal Tracker 进行 关键 字 检索 


PIV (@) TALTRACKER PROJECTSv DASHBOARD REPORTS HELP TAK/| 
LeadSegmentEngine My Sample Projec Other Products SI SSS 














CURRENT BACKLOG ICEBOX EPICS ”MORE PROJECT "STORIES v 全 括 儿 之 > 口 一 上 


show 1 matching done story 


”个 _ 名 一 并 下 载 时 文件 名 中 混入 了 多 余 的 文字 ( 康 奥 ) 
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e…… 通 过 问题 票 查找 代码 修改 
找到 的 问题 票 中 记载 有 指向 GitHub 修改 记录 的 链接 (图 4.22 )。 
4.22 ”修改 记录 的 链接 








v 








批量 下 载 时 的 文件 名 中 混 有 多 余 的 文字 加 








[gjipJassst579]| More | | Save | Glose 





























STORY TYPE 请 Feature 7 

POINTS _ 1Point Y 

REQUESTER 康 树 奥 村 

OWNER 康 树 奥 村 了 

BUGZILLAID 24127 
Requested 15 May 2013, 8:09am 








DESCRIPTION 
通过 批量 下 载 下 载 的 文件 名 中 混 有 多 余 的 文字 



































LABELS 
"| 

TASKS 

| Add a task | 
ACTIVITY All Activity ~ 
| Commit by buster84 24 May 2013, 6:27pm 
| 中 [Fixed #49891579 #49891623 #49891631] Create report 

file after syncing data. 


https//github.com/Shanon/DeeElle/commit 
/201aa967f01653c6f2a8e3c836e3f455541524ba 








点 击 链接 就 会 跳 转 到 GitHub 对 应 的 提交 页 面 ， 在 此 可 以 查看 提交 
代码 的 差分 对 比 ( Diff) (图 4.23 )。 
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4.5 回答 “那个 bug 是 什么 时 候 修正 的 ”的 问题 











图 4.23 ”GitHub 的 修改 记录 








© 日 my .= =acommand 加 | 闪 Explore Gist Blog Help 二 keke443 了 多 愉 
Shanon / DeeElle 门 pullRequest 信 Watch 让 Star 0 洲 Fork 2 
加 Code Network Pull Requests 0 lssues 2 Wiki Graphs Settings 
tree:201aa96710 . Files | Commits ” Branches 久 Tags 本 
[Fixed #49891579 #49891623 #49891631] Create report file after syncin... Browse code 
-9 data. 
了 了 master 
buster84 authored 6 days ago 1 parent 6396429 commit 291aa967f61653c6f2a8e3c836e3f455541524bo 
Zi Showing 15 changed files with 224 additions and 151 deletions- Show Diff Stats 
View file @ 201aa96 





amumm opp/Global.scala 


8 19,6 +19,8 88 import org.joda.time.DateTime 
import org.joda.time.Period 
import org.joda.time.Duration 


+import models.output.ReportHandler 
+ 
object Global extends Globalsettings { 


var cancellable :Cancellable = null 
t Global extends Globalsettings { 
Errorride def anstartfapp: APPLoatica) = 
val something = super.onstart(app) 


+ val tmpDirectory = Play.current.configuration.getstring("file.tmpdirectory").getorElse("/tmp/dl") 
val jobName = "deeElle jobl" 
val span = Play.current .configuration.getInt("job.schedule.span").getOrElse(60 * 24) 
val limit = Ppl configuration.getInt(" bd schedule.limit").getorElse(1) 






extends Global 
-> DataBuilder.sal Sunmaryreport (prefix)) 








"summaryreport save” 


DataBuilder .updateTargetCollectionNames (prefix) 
+ ReportHandler .createReportFiles(tmpDirectory, prefix) 


Logger.info(serialization.write(result) (net.liftweb. json.DefaultFormats)) 


} 


215 Do opp/controllers/Main. scala View file @ 201aa96 


Package controllers 





import models._ 
+import models.output.ReportHandler 





这 样 就 查 到 了 对 应 的 代码 提交 纪录 。 接 着 只 要 查 出 这 个 提交 反映 到 


了 哪个 发 布 版 本 “， 调 查 就 基本 可 以 结束 了 。 


根据 运用 方式 的 不 同 ， 例 如 在 master 分 支 适当 地 打上 发 布 标签 并 进 





行 发 布 的 情况 下 ， 只 需要 确认 提交 是 否 反 映 到 master 分 文 ， 就 能 够 判断 
是 否 反映 到 某 个 版 本 的 发 布 中 了 。 


4.5.2 ”Backlog 的 例子 





再 举 一 个 Backlog 的 例子 。 这 次 版 本 管理 系统 使 用 Subversion 。 








中 


通常 以 标签 的 形式 保存 。 
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在 Backlog 的 画面 上 设置 检索 条 件 ， 对 问题 票 进行 检索 ( 图 4.24 )。 
这 里 以 “程序 令 牌 ”作为 关键 字 来 检索 。 


图 4.24 ”检索 问题 票 





查询 课题 《所 有 项 目 范 围 内 日 

















ee | 本 wa 
ro Em | 加 二 蜂 



































as | 
ee 
夫 本 1 -20 24 下 - 丙 。 ER SEXErsg 的 cey 的 Fenl 放 fpSN 
Es 3 [mw | gem | aes | wma | Henin | mw | RM | ra | wan | tw me| ws] 
[MM 中 am ne reg Pr” 和 本 




















确认 找到 的 问题 票 的 内 容 ( 图 4.25 )。 


4.25 ”问题 票 的 内 容 

















SSAPI-21 | 多 | 提交 日 期 : 2011/12/15 15:10:28 | 开始 日 : 2011/12/15 | 期限 日 : 2011/12/15 


给 SsApiCommon 添加 重新 取得 Token 的 功能 











种 类 Task 优先 级 ” 中 

类 别 结束 理由 

版 本 状态 ”结束 

里 程 碑 责任 者 【shanon 】 池 田 尚 史 
预计 使 用 时 间 (小 时 ) 2 实际 使 用 时 间 ( 小 时 ) 





详细 Ln 【 shanon 】 池 田 尚 史 坟 t 














2011/12/15 18:18 Dn) 【 shanon 】 池田 尚 史 张 + | 引用 | 编辑 | 删除 会 
吕 状态， 未 处 理 -> 处 理 完毕 
9 提交 : r231 
SSAPI-21 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
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问题 票 中 有 提交 记录 的 链接 ， 点 击 链接 就 能 确认 提交 的 内 容 (图 
4.26 ), 


图 4.26 ”提交 记录 列表 
修改 F231 a 





和 返回 上 一 页 
<< 上 一 个 修改 ( r230 ) 下 一 个 修改 ( r232 ) >> 





修改 概要 





更 新 时 间 2011/12/15 18:18 
更 新 者 Ln) 【 shanon 】 池 田 尚 史 寿 + 
评论 。 SSAPI-21 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
#fixed 








Commit 会 影响 路 径 名 字 





修改 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Activityjava [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

修改 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Application.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

著 : ssApicommonjtrunk/src/main/java/jp/co/shanon/ss/api/services/Session.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

修改 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Visitor.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

著 : ssApicommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorApplicationjava 【显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 
国 国 : ssApiCcommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorFilejava 【显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 


还 可 以 通过 Di 企 来 比较 代码 的 内 容 (图 4.27 )。 
4.27 ”比较 代码 内 容 


5 此 1231 四 区分 




















Spin 

















beet 
te 





这 样 就 通过 Backlog 将 从 调查 到 代码 的 修改 这 一 整个 过 程 串联 起 来 
了 。 接 着 也 同样 只 需要 调查 清楚 这 些 提 交 反 映 到 了 哪个 版 本 的 发 布 中 就 
可 以 了 。 
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4.6 回答 “为 什么 要 这 样 修改 ”的 问题 


在 4.5 节 中 ， 我 们 说 明了 根据 调查 查找 代码 修改 的 例子 。 而 在 团队 
开发 现场 还 存在 相反 的 、 从 代码 追溯 问题 票 的 情况 。 例 如 在 本 地 编译 失 
败 或 者 单元 测试 失败 的 情况 下 ， 就 需要 通过 缺陷 管理 系统 和 版 本 管理 系 
统 的 提交 记录 ， 追 查 出 造成 失败 的 问题 票 。 

但 是 这 个 功能 的 前 提 条 件 是 必须 由 单个 系统 统一 提供 缺陷 管理 和 版 
本 管理 。 例 如 Backlog 会 自动 地 同步 生成 从 提交 记录 到 问题 票 的 链接 ， 
能 够 简单 地 从 代码 修改 链接 到 问题 票 。 从 图 4.26 中 可 以 看 出 ， 提 交 记 录 
也 添加 有 问题 票 的 链接 。 

Trac 和 Redmine 基本 与 Backlog 一 样 。GitHub 会 在 提交 记录 中 自动 
添加 自身 的 Issue 功能 的 链接 。 上 述 以 外 的 缺陷 管理 系统 基本 上 都 无 法 
自动 添加 链接 。 在 这 样 的 情况 下 ， 可 以 采用 复制 提交 记录 的 版 本 号 并 粘 
贴 到 所 使 用 的 缺陷 管理 系统 中 等 方法 来 应 对 。 虽 然 稍 显 原始 ， 但 比 起 没 
有 任何 信息 、 完 全 无 从 调查 的 状况 来 说 还 是 要 好 很 多 。 
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4.7 ”本 章 总 结 


综 上 所 述 ， 通过 关联 缺陷 管理 系统 和 版 本 管理 系统 ， 代 码 的 可 追溯 
性 有 了 很 大 的 提高 。 

本 章 介 绍 了 包括 免费 /收费 在 内 的 各 类 和 缺陷 管理 系统 。 最 近 几 乎 所 
有 的 缺陷 管理 系统 都 提供 了 和 版 本 管理 系统 进行 关联 的 功能 ， 这 里 对 关 
联 的 方法 也 进行 了 说 明 。 

通过 关联 缺陷 管理 系统 和 版 本 管理 系统 并 加 以 有 效 地 利用 ， 就 能 够 
知道 什么 时 候 、 谁 、 进 行 了 什么 操作 这 一 连 串 的 信息 ， 并 且 还 能 加 快 发 
生 问 题 时 查找 原因 的 速度 。 

这 和 既 不 使 用 缺陷 管理 系统 也 不 和 版 本 管理 系统 进行 关联 的 情况 比 
起 来 可 以 说 是 天 壤 之 别 。 请 回忆 一 下 第 2 章 中 的 案例 分 析 。 在 那个 案例 
中 ， 收 到 通过 邮件 发 来 的 调查 请 求 ， 却 无 法 检索 版 本 管理 系统 的 提交 记 
录 ， 即 便 确认 了 提交 记录 也 不 知道 这 样 修改 的 理由 。 

第 2 章 的 案例 分 析 中 还 有 个 例子 是 : 根据 收 到 的 调查 请 求 进行 的 修 
改 被 其 他 开发 人 员 用 别 的 提交 覆盖 掉 了 。 如 果 关 联 了 缺陷 管理 系统 和 版 
本 管理 系统 的 话 ， 就 能 从 提交 记录 找 出 对 应 的 问题 票 ， 进 而 就 应 该 能 知 
道 进行 如 此 修改 的 缘由 。 

但 即使 这 样 还 是 觉得 有 所 不 足 ， 并 不 是 说 仅仅 找 出 有 问题 的 提交 ， 
并 调查 出 作为 提交 原因 的 问题 票 就 足够 了 。 不 能 一 开始 就 阻止 这 样 有 问 
题 的 提交 吗 ? 不 能 在 每 次 提交 时 都 对 其 正确 性 进行 检查 吗 ? 

如 果 能 够 实现 上 述 机 制 ， 就 能 在 更 早 的 阶段 确保 提交 的 正确 性 ， 开 
发 的 质量 也 会 相应 地 提高 。 这 样 的 机 制 就 是 将 在 第 5 章 进行 说 明 的 CI。 



































































































































专栏 ”缺陷 管理 、bug 管理 以 及 需求 管理 


本 章 主 要 讲述 了 用 缺陷 管理 系统 对 开发 中 的 任务 进行 管理 的 相 
关内 容 。 而 在 任务 确立 之 前 的 阶段 ， 软 件 开 发 团队 还 有 必要 对 课题 
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进行 管理 。 
缺陷 管理 系统 能 够 覆盖 哪些 范围 呢 ? 或 者 说 应 该 覆盖 哪些 范 
局 呢 ? 

这 里 我 们 借鉴 敏捷 开发 方法 论 之 一 的 Scrum 的 部 分 术语 ， 将 课题 
分 为 epic、story、task、bug 这 4 类 ， 并 分 别 对 它们 的 粒度 进行 说 明 。 











































































































epic ( 很 大 的 需求 、 跨 部 门 的 课题 等 ) 

可 以 称 为 epic 的 大 粒度 的 课题 一 般 有 如 下 特征 。 不 熟悉 epic 这 
个 术语 的 话 可 以 回想 一 下 系统 需求 确定 下 来 之 前 的 需求 定义 阶段 ， 
这 样 会 比较 容易 理解 。 


















































@ 和 工程 师 不 相关 的 事情 占 多 数 

@ 以 确定 优先 顺序 为 主要 目的 ， 因 此 以 一 览 表 的 形式 呈现 出 来 
很 重要 

@ 刚 开 始 时 多 处 于 模糊 的 状态 ， 因 此 不 适合 采用 固定 的 格式 ， 
最 好 是 能 够 灵活 修改 的 

@ 方便 多 人 进行 编辑 、 共 享 









































这 样 的 粒度 下 一 般 会 使 用 电子 表格 工具 。 因 为 工程 师 之 外 的 甘 
队 成 员 也 能 够 直观 地 进行 编辑 ， 所 以 是 最 简便 的 方法 。 如 果 考 虑 型 
共享 和 同时 编辑 的 问题 ， 最 好 使 用 GoogleDocs 这 样 的 在 线 工 具 。 

















































































































epic 的 内 容 示例 : 
@ 构 贷 开拓 新 市 场 用 的 系统 
@ 为 每 个 客户 准备 信息 中 心 ， 提 供 对 其 所 使 用 的 产品 的 统计 信 
息 和 用 户 的 访问 情况 进行 分 析 的 功能 


story ( 具体 的 需求 ， 和 功能 性 需求 或 规格 程度 相近 ) 

称 为 stroy 的 粒度 有 如 下 这 些 特 征 。 它 在 Scrum 中 表示 为 用 户 
带 来 的 价值 。 如 果 对 Scrum 不 熟悉 的 话 可 以 理解 为 程度 上 近似 于 具 
体 的 功能 要 求 或 规格 。 




































































@ 一 般 多 由 产品 的 负责 人 编写 ( Scrum 中 的 用 语 是 product owner ) 
@ 根据 团队 或 项 目的 情况 ， 可 以 由 工程 师 以 外 的 成 员 编写 ， 也 
可 以 由 程序 员 编写 
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@ 需要 进行 状态 管理 
@ 最 好 开始 和 代码 建立 关联 
@ 负责 人 可 以 是 多 人 也 可 以 是 一 个 人 



































这 样 的 粒度 可 以 考虑 使 用 缺陷 管理 系统 进行 管理 。 关 系 到 多 个 
负责 人 的 大 型 story 的 话 需要 再 想 想 办 法 。 

方法 之 一 就 是 先 建立 问题 票 再 分 割 为 子 任务 。 如 果 系 统 支持 在 
问题 票 之 间 建 立 继 承 关系 ， 可 以 直接 使 用 该 功能 ， 这 样 管理 起 来 也 
较为 方便 。 

根据 相关 人 员 的 数量 ， 也 可 能 是 使 用 电子 表格 工具 进行 管理 
为 理想 。 至 于 应 该 如 何 确定 缺陷 管理 系统 和 电子 表格 工具 的 分 界线 ， 
可 个 项 目 、 每 个 团队 都 有 自己 不 同 的 标准 ， 很 难说 哪个 是 最 好 的 ， 
请 根据 项 目的 实际 情况 探讨 合适 的 方法 。 

比较 常用 的 方法 是 以 团队 为 分 界线 。 如 果 课 题 涉及 多 个 部 门 ， 
可 以 采用 电子 表格 工具 进行 管理 ， 等 具体 的 开发 内 容 确 定 下 来 后 
各 部 门 自行 建立 问题 票 。 由 于 管理 方面 职责 明确 ， 因 此 较 大 的 
发 团队 多 采用 该 方法 。 











































































































































































































































































































































































































































































































stroy 的 内 容 示例 : 
@ 为 了 体现 出 对 顾客 的 欢迎 ， 想 要 在 顾客 登录 时 根据 顾客 的 信 
息 显示 欢迎 或 其 他 消息 等 
@ 将 每 个 用 户 ID 的 用 户 访 问 状况 ， 以 小 时 、 属 性 分 别 进行 统 
计 ， 并 且 支 持 在 信息 中 心 阅览 和 下 载 


task 
即 作 业 。 和 价值 没有 直接 关系 ， 但 如 果 不 完 成 task 的 话 story 
的 完成 就 无 从 谈 起 。task 的 概念 应 该 还 是 比较 容易 理解 的 。 









































@ 具体 的 作业 内 容 
@ 大 致 的 印象 是 story 下 关联 着 多 个 task 
@ 只 有 一 个 负责 


@ 根据 内 容 确定 是 否 需要 和 代码 进行 关联 



































task 应 该 采用 缺陷 管理 系统 进行 管理 。 如 果 系 统 支 持 问题 票 之 
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间 有 继承 关系 ， 或 者 允许 在 问题 票 下 定义 附属 问题 票 ， 可 以 将 story 
定义 为 问题 票 ， 将 task 定义 为 子 问题 票 或 者 附属 问题 票 。 









































task 的 内 容 示例 : 
@ 初始 化 系统 
@ 写 单 元 测试 


bug、 故 障 处 理 、 调 查 
即 OA 部 门 发 来 的 bug 报告 、 故 障 的 处 理 以 及 顾客 的 咨询 等 。 





@ 程度 上 和 task 相近 
@ 通常 由 单个 开发 人 员 负 责 
@ 需要 和 代码 进行 关联 
































应 该 作为 缺陷 管理 系统 的 管理 对 象 。 至 于 是 以 task 的 粒度 进行 

管理 还 是 以 story 的 粒度 进行 管理 ， 可 以 根据 项 目 或 团队 的 具体 情况 
选择 合适 的 方式 。 
在 bug 数量 很 多 的 情况 下 ， 可 以 将 bug 管理 和 其 他 的 问题 票 区 
分 开 ， 使 用 其 他 的 系统 进行 管理 。 这 也 是 一 种 方法 ， 但 这 样 的 话 管 
理 上 就 会 变 得 复杂 ， 所 以 并 不 推荐 。 应 该 尽 可 能 地 在 同一 缺陷 管理 
系统 下 对 story 和 bug 进行 管理 。 



























































































































































































































































“至 此 我 们 一 起 看 了 课题 的 分 类 和 管理 方 。 这 样 的 分 类 方法 是 
灵活 的 ， 并 非 一 成 不 变 的 。 如 果 团队 有 自己 一 贯 采用 的 分 类 方法 也 
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oo 











































































































能 够 肯定 的 是 : 缺陷 管理 系统 适用 于 目的 以 及 内 容 在 一 定 程度 上 
确定 下 来 之 后 的 管理 ， 不 适合 在 此 之 前 的 那些 比较 模糊 的 、 不 确定 
9 事物 的 管理 。 在 这 个 阶段 ， 使 用 电子 表格 工具 等 形式 不 国定 的 
具 进 行 管 理会 比较 好 。 

表格 工具 和 缺陷 管理 系统 的 分 界线 取决 于 相关 的 部 门 数 或 人 数 ， 
另外 ， 在 负责 的 部 门 发 生变 化 时 切换 到 缺陷 管理 系统 也 是 可 以 的 。 

没有 必要 只 使 用 一 种 工具 ， 同 样 ， 也 没有 必要 拘泥 于 一 种 定义 ， 
我 们 要 做 的 应 该 是 摸索 出 一 套 最 适合 自己 团队 的 方法 。 
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5.1 CI ( 持续 集成 ) 


5.1.1 什么 是 Cl ( 持续 集成 ) 




















团队 开发 中 最 重要 的 工作 是 什么 ?是 编码 等 开发 工作 ?还 是 测试 工 
作 ? 当然 这 些 工作 都 是 团队 开发 中 基本 且 重 要 的 工作 。 但 是 为 了 顺利 地 
推进 由 多 人 参与 的 开发 以 及 测试 ， 最 重要 的 基础 是 “集成 ”。 














@…… 集成 ( integration ) 








将 各 个 成 员 的 工作 成 果 集 中 到 一 处 进行 集成 ， 直 到 形成 可 以 运行 的 
系统 ， 各 个 成 员 的 开发 工作 才 有 了 意义 ， 才 能 进行 测试 ， 最终 才 能 以 产 
品 的 形式 向 顾客 提供 价值 。 

集成 ， 具 体 来 说 就 是 像 下 面 这 样 执行 build 和 测试 的 流程 。 





























e@ 将 所 有 的 代码 集中 到 一 处 

e@ 设置 依赖 程序 库 等 的 路 径 

e@ 必要 的 情况 下 进行 编译 

@ 进行 数据 库 构 建 和 数据 加 载 

@ 必要 的 情况 下 对 中 间 件 进行 配置 和 启动 

@ 实施 单元 测试 、 集 成 测试 、 用 户 验 收 测试 等 


e-……- 持 续 地 进行 集成 就 是 C 


ee i 程 持续 地 执行 ， 就 是 CI ( Continuous Integration ， 
持续 集成 ) 








中 ”如 果 从 一 开始 就 能 实现 之 前 提 到 的 所 有 集成 处 理 流程 的 自动 化 ， 这 个 自然 是 最 理 
想 的 。 但 这 将 耗费 大 量 的 时 间 和 精力 ， 因 此 没有 必要 将 实现 所 有 集成 处 理 的 自动 
化 作为 目标 。 不 仅仅 是 CI， 类 似 的 实践 的 效果 以 及 对 应 的 开销 都 需要 进行 权衡 。 
因此 ， 可 以 先 从 自己 项 目 所 必要 的 处 理 开始 实现 自动 化 。 
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原本 CI 是 作为 敏捷 开发 方法 之 一 的 极限 编程 (eXtreme Programming， 
XP ) 的 实践 项 目 被 提出 的 。 其 实 可 以 毫 不 过 分 地 说 ， 在 以 高 品质 、 快 速 
地 提供 有 价值 的 软件 为 目标 的 敏捷 开发 中 ，CI 是 最 基本 、 最 重要 的 
实践 。 

在 以 前 的 瀑布 模型 开发 "中 , 一 般 要 等 到 所 有 的 开发 工作 都 结束 后 ， 
到 测试 阶段 时 才 开 始 着 手 进行 集成 。 

想必 读者 都 有 过 这 样 的 经 验 : 直到 测试 阶段 才 开始 实施 集成 ， 往 往 
会 出 现 程序 库 缺 失 、 数 据 库 构 建 失败 、 编 译 无 法 通过 等 问题 。 集 成 的 实 
施 越 迟 、 代 码 的 量 越 大 ， 就 越 困 难 。 

要 集成 多 名 团队 成 员 的 作业 内 容 更 是 一 件 相当 麻烦 的 工作 ， 因 此 往 
往 容易 往 后 拖延 。 但 是 只 有 经 过 了 集成 这 个 步骤， 程序 才能 作为 一 个 整 
体 开始 运行 。 在 进行 集成 之 前 ， 确 认 产 品 是 否 满足 需求 ， 是 否 有 奇怪 的 
bug 等 检 证 工作 也 无 法 开展 。 可 见 拖延 并 不 是 一 个 好 办 法 。 

不 将 复杂 的 集成 处 理 推 后 ， 而 是 在 开发 中 时 常 地 进行 集成 处 理 ， 由 
此 来 排除 软件 开发 中 的 复杂 性 ， 这 就 是 CI 的 思考 方式 。 




















































































































5.1.2 ”使 开发 敏捷 化 


@…… 瀑布 式 开发 的 开发 阶段 

过 去 的 瀑布 式 开发 是 在 需求 定义 完成 后 进行 设计 、 开 发 ， 之 后 再 依 
次 进行 单元 测试 、 集 成 测试 、 用 户 验 收 测试 ， 因 此 到 开始 正式 提供 服务 
的 开发 周期 容易 拖 得 很 长 (图 5.1 )。 
































中 将 系统 的 开发 流程 分 为 分 析 、 设 计 、 编 码 、 测 试 、 部 署 等 阶段 ， 并 按 上 述 顺 序 依 
次 进行 作业 的 开发 模型 。 
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图 5.1 ”瀑布 式 开发 的 开发 阶段 





需求 定义 户 验 收 测试 




























































开发 全 部 完成 后 才 开始 单元 测试 ， 这 就 意味 着 如 果 开 发 周期 为 3 个 
月 ,那么 多 名 开发 人 员 为 期 3 个 月 所 编写 的 代码 直到 单元 测试 阶段 才 第 
一 次 集中 到 一 处 进行 build。 在 此 之 后 还 有 集成 测试 和 用 户 验 收 测试 。 

从 图 5.1 就 能 看 出 ， 从 需求 定义 确定 下 来 ， 到 用 可 以 实际 和 运行 的 程 
序 进行 验证 ， 这 期 间 的 时 间 间 隔 非 常 大 。 甚 至 会 有 在 项 目 临近 结束 时 还 
需要 重新 返工 的 风险 。 

瀑布 式 开发 是 确保 各 阶段 的 正确 性 之 后 再 开始 下 一 阶段 ， 因 此 理论 
上 在 进入 下 一 个 阶段 后 就 不 应 该 返回 上 一 阶段 。 但 实际 上 ， 很 多 事情 只 
有 在 目睹 运行 的 系统 后 才 会 知道 。 正 如 读者 所 知 ， 很 多 采用 瀑布 式 开发 
的 项 目 直到 临近 结束 还 在 修改 需求 、 重 新 编码 并 重新 测试 。 


@…… 敏捷 开发 的 开发 阶段 

与 之 相对 ， 以 Scrum 为 代表 的 敏捷 开发 采取 了 相反 的 方式 ， 即 以 
sprint 这 样 较 短 的 周期 来 循环 实施 设计 开发 、 单 元 测试 、 集 成 测试 、 用 
户 验收 测试 ( 图 5.2 )。sprint 的 周期 因 项 目 而 异 ， 通 常 多 设 定 为 两 周到 1 
个 月 。 
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图 5.2 ”敏捷 开发 的 开发 阶段 


ee 
[review 外 八 开发 ] 【review 】 上 开发 | (review | 开发 


> 


QQ ~ \ 一 一 一 


两 周 两 周 两 周 





























Scrum 以 sprint 为 周期 提交 工作 成 果 ， 并 以 sprint review 这 样 的 流 
程 对 工作 成 果 进 行 审查 ， 给 出 反馈 ， 并 反映 到 下 一 个 sprint 的 作业 中 。 
以 正式 提供 服务 为 目标 “, 重复 上 述 过 程 。 上 述 流程 可 以 理解 成 将 瀑布 式 
开发 中 从 需求 定义 到 用 户 验 收 测试 的 过 程 浓缩 到 为 期 两 周 的 Sprint 内 进 
行 ”。 这 样 的 方式 能 够 及 早 地 检查 出 产品 和 需求 之 间 的 差异 ,调整 的 机 会 
也 会 相应 增加 。 

CI 是 敏捷 开发 的 基础 中 最 重要 的 实践 。sprint 中 的 工作 成 果 通 常 是 
指 “ 可 以 确认 满足 某 种 需求 的 可 运行 的 程序 ”， 进 一 步 说 就 是 “可 以 判 
断 是 否 能 够 正式 投入 运营 的 可 运行 程序 ”。 要 在 短 短 两 周 的 时 间 内 制作 
出 可 以 运行 的 产品 ， 如 果 还 要 在 集成 上 花费 时 间 是 肯定 来 不 及 的 。 更 何 
况 是 到 了 sprint 的 后 期 才 开 始 集成 并 测试 ， 无 论 如 何 都 是 来 不 及 的 。 
此 就 需要 每 天 进行 开发 、 集 成 、 测 试 这 样 的 循环 ， 这 就 是 CI。 换 言 之 ， 
build 和 测试 的 自动 化 途径 将 是 至 关 重 要 的 。 
































































































































G@ 进一步 来 说 ， 上 线 运营 与 其 说 是 终点 ， 倒 不 如 说 是 开始 。 如 果 能 在 上 线 后 持续 进 
行 sprint， 反 复 地 改善 和 审查 ， 就 可 以 向 顾客 提供 更 多 的 价值 。 

@ 当然 要 在 两 周 内 实现 所 有 的 需求 是 不 可 能 的 。 因 此 要 排出 需求 的 优先 顺序 并 估计 
工 数 、 制 定 计划 。 从 优先 度 高 的 项 目 开 始 ， 按 顺序 投入 到 sprint 开发 中 。 在 每 次 
的 Sprint review 中 检查 开发 状况 ， 并 根据 市 场 的 变化 ， 一 边 调整 优先 度 一 边 进入 
下 一 个 开发 周期 ， 这 就 是 敏捷 开发 。 这 里 的 估计 工 数 和 制定 计划 是 敏捷 开发 中 最 
困难 、 同 时 也 是 最 有 趣 的 部 分 。 本 书 就 不 详 述 了 ， 有 兴趣 的 读者 可 以 参考 下 面 的 
文献 资料 。 
《敏捷 估计 与 规划 》 ( 美 ) Mike Cohn 著 ， 宋 锐 译 ， 清 华 大 学 出 版 社 ，2007 
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无 论 是 从 自动 化 集成 的 角度 还 是 从 其 他 角度 来 看 ，CI 都 是 非常 重要 
的 。 之 前 已 经 提 到 过 ，Scrum 以 sprint 周期 为 粒度 反复 进行 review 和 反 
馈 。 实 现 CI 的话 ， 编 程 作业 和 自动 化 测试 的 循环 就 能 粒度 更 细 、 运 转 
更 迅速 。 自 动 测试 的 结果 正 是 程序 是 否 正确 运行 的 反馈 。 

也 就 是 说 ， 如 图 5.3 所 示 ， 项 目 整体 以 sprint 为 粒度 进行 反馈 ， 并 
这 样 不 断 循环 。 而 每 个 sprint 中 又 进一步 以 CI 为 粒度 进行 反馈 ,同样 进 
行 着 循环 。 这 样 就 构成 了 藤 套 的 结构 图 。 


5.3 sprint 和 CI 的 循环 


review | 开发 (review ( 发 (review 人 开发 































































































以 这 样 的 粒度 快速 进行 反馈 的 循环 ， 就 能 够 在 快速 开发 的 同时 确保 
产品 的 质量 ， 这 就 是 敏捷 开发 。 而 在 背后 支撑 着 敏捷 开发 的 就 是 CI 这 
样 的 实践 。 
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那么 为 何 CI 和 敏捷 开发 近年 来 逐渐 走红 "了 呢 ? 想 知 道 答案 的 话 就 
需要 从 以 下 两 个 角度 出 发 来 思考 。 


@ 成 本 效益 ( cost benefit ) 
@ 市 场 变化 的 速度 


一 般 而 言 ，bug 出 现 的 时 间 越 长 ， 修 改 该 bug 的 成 本 就 越 高 。 例 如 
使 用 刚刚 编写 的 代码 当场 进行 测试 ， 即 使 发 现 了 bug， 查 明 原 因 并 进行 
修改 也 是 比较 容易 的 。 

与 之 相对 ， 如 果 不 进行 测试 直接 提交 代码 ，3 天 后 才 注 意 到 bug 的 
话 会 怎么 样 呢 ? 两 周 后 、!1 个 月 之 后 会 怎么 样 呢 ? 那 时 所 写 的 代码 的 内 
容 可 能 已 经 记 不 太 清 了 ， 其 他 开发 人 员 也 可 能 对 该 代码 进行 过 提交 了 ， 
修改 bug 的 难度 将 大 大 提升 。 而 如 果 是 3 个 月 后 或 半年 后 才 发 现 ， 想 想 
就 觉得 非常 恐怖 了 。 

实现 build 和 测试 的 自动 化 ， 并 且 能 够 实施 CI 的 话 就 能 解决 这 个 问 
题 。 通 过 实施 CI， 提 交 之 后 就 能 立即 察觉 是 否 有 bug 产生 ， 修 改 bug 的 
成 本 将 大 大 降低 。 所 以 说 CI 的 实施 能 大 大 提高 成 本 效益 。 

这 里 所 说 的 成 本 主要 是 指 修 改 bug 相关 的 经 济 方面 的 成 本 ， 除 此 之 
外 还 有 其 他 需要 注意 的 成 本 ,例如 可 维护 性 相关 的 成 本 。 

保持 代码 清晰 易 读 、 添 加 功能 方便 ， 这 是 长 期 维护 产品 中 非常 重要 
的 。 不 仅 是 单纯 地 加 快 增加 新 功能 的 速度 所 带 来 的 经 济 方面 的 优点 ， 在 
保持 负责 维护 和 功能 开发 的 团队 成 员 的 精神 健康 以 及 提高 开发 效率 方 卫 











































































































中 这 里 虽然 是 说 近年 来 才 逐 渐 走红 ， 事 实 上 CI 这样 的 思考 方式 很 早 之 前 就 有 了 。 
比如 《程序 员 修 炼 之 道 》( Andrew Hunt、David Thomas 著 ， 马 维 达 译 ， 电 子 工业 
出 版 社 ，2011 年 ) 中 就 提 到 了 自动 化 测试 的 必要 性 ;Joel on Sofiware ( Avram 
Joel Spolsky，APress，2004 年 ) 中 也 以 专栏 的 形式 介绍 了 自动 化 build 和 自动 
化 测试 对 提高 工作 效率 的 作用 。 近 年 来 随 着 相应 工具 的 出 现 ，CI 也 开始 逐渐 普 
及 了 。 
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都 会 起 到 很 大 的 作用 。 
e…… 市场 变化 的 速度 


如 今 的 市 场 瞬息 万 变 。 特 别 是 网 站 和 智能 手机 的 App，1 款 产品 的 
开发 周期 一 般 不 足 1 至 2 年 。 因 为 在 开发 期 间 市 场 趋 势 很 可 能 会 发 生变 
化 ， 导 致 开发 出 来 的 产品 失去 作用 。 还 有 Web 之 外 的 一 些 类 似 于 财务 系 
统 这 样 的 业务 系统 ， 还 会 受到 突然 的 政策 修改 等 外 部 环境 变化 的 影响 。 
如 果 每 次 都 按照 瀑布 式 的 开发 流程 ， 从 头 开始 全 部 实施 的 话 ， 可 以 
说 很 难 跟 上 市 场 的 变化 。 话 昌 如 此 ， 如 果 只 是 单纯 地 提早 发 布 日 期 、 缩 
短 开发 日 程 ， 而 不 在 CI 等 方面 下 工夫 的 话 ， 那 只 会 造成 bug 和 退化 频 
发 ， 进 而 导致 发 布 的 产品 质量 下 降 。 效 果 恰 恰 相反 。 

为 了 应 对 市 场 的 变化 ， 在 一 定 程度 上 不 得 不 牺牲 代码 的 可 读 性 和 可 
维护 性 。 特 别 是 在 产品 开发 初期 ， 这 是 常 有 的 事情 。 不 同 的 产品 可 能 
所 差异 ， 一 般 而 言 投入 市 场 越 迟 ， 就 越 容 易 失 去 机 会 。 最 差 的 情况 下 ， 
辛苦 开发 的 产品 可 能 完全 没有 被 用 户 接受 的 机 会 ， 产 品 开发 的 投入 完全 
打 了 水 漂 。 












































































































































e@-…. 兼顾 开发 速度 和 质量 


如 何 才能 既 保持 能 够 应 对 市 场 变 化 的 开发 速度 ， 又 保证 高 质量 呢 ? 
CI 就 能 起 到 重要 的 作用 。 

例如 ， 编 写 能 确保 产品 API 正常 运行 的 最 低 限 度 的 测试 代码 并 执行 
CI， 在 保证 代码 内 容 正 常 运 行 的 基础 上 优先 向 市 场 进行 发 布 。 这 个 阶段 
代码 的 可 读 性 和 可 维护 性 较 差 ， 功 能 添加 也 不 方便 ， 只 是 姑且 能 够 运行 
并 向 用 户 提供 价值 而 已 。 
认 产 品 能 够 正常 使 用 之 后 ， 再 用 考虑 了 之 前 牺牲 的 可 读 性 和 可 维 
护 性 的 代码 来 替换 原来 的 代码 。 这 是 为 了 应 对 下 一 个 阶段 ， 即 进一步 添 
加 功能 所 必需 的 。 
电 就 是 说 ， 初 期 优先 速度 ， 致 力 于 尽快 上 市 ， 之 后 再 对 代码 进行 重 
构 以 提高 可 维护 性 。 而 支持 上 述 方式 的 正 是 CI， 有 了 CI 上 述 方式 才 成 
为 可 能 。 既 应 对 了 市 场 的 快速 变化 ， 又 控制 了 确保 可 维护 性 和 开发 人 员 
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精神 健康 所 需 的 成 本 。 
综 上 ， 从 成 本 效益 和 市 场 的 变化 速度 这 两 个 角度 来 看 ，CI 这 样 的 实 
践 是 非常 重要 的 。 





5.1.4 Cl 的 必要 条 件 


“CI 的 字面 意思 已 经 理解 了 ， 想 开始 着 手 实施 ， 应 该 怎么 做 呢 ?” 从 
何 处 着 手 呢 ?” 为 了 回答 这 样 的 问题 ， 我 们 来 说 一 下 CI 的 必要 条 件 。 
开始 实施 CI 的 必要 条 件 如 下 。 








e@ 版 本 管理 系统 
e@ build 工具 

e@ 测试 代码 

e@ Cl 工具 


e@…… 版 本 管理 系统 


实施 CI 过 程 中 最 重要 的 部 分 就 是 版 本 管理 系统 。 正 如 第 3 章 中 所 
讲解 的 那样 ， 构 建 程序 所 必需 的 资源 应 该 尽 可 能 地 由 版 本 管理 系统 进行 
统一 的 管理 ， 这 是 非常 重要 的 。 例 如 代码 、 依 赖 关系 、 数 据 库 模 式 、 配 
置 文件 等 。 使 用 版 本 管理 系统 ， 任 何人 、 任 何 时 候 都 能 够 获取 最 新 的 资 
源 是 非常 重要 的 。 












































@.……. build 工具 





同样 重要 的 还 有 build 工具 。 例 如 make， 写 好 build 的 定义 后 ， 上 5 
要 执行 一 条 命令 ， 就 能 够 进行 代码 编译 、 数 据 库 构 建 和 测试 ， 并 最 终生 
成 可 以 运行 的 程序 。 主 要 的 build 工具 如 表 5.1 所 示 。 
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表 151 主要 的 build 工具 
build 工具 | 说明 




























































































make 经 典 的 build 工具 。 根 据 Makefile 这 样 的 配置 文件 进行 build。UNIX 
下 的 软件 build 所 必 不 可 少 的 工具 ， 负 责 搭 建 服 务 器 的 工程 师 每 天 都 会 
接触 
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build 工具 | 说 明 

SCons Python 编写 的 替代 make 的 工具 。 使 Python 写 的 配置 文件 
SConstruct 进行 build。 支 持 各 种 语言 的 build， 在 OSS 界 有 着 一 定 的 

占有 率 。 比 较 有 名 的 是 V8 7 的 build 就 使 用 了 该 工具 

Ant Java 写 的 build 工具 ， 使 用 名 为 build.xml 的 XML 文件 来 定义 build 顺 

郭 。 因 为 要 定义 build 顺序 ， 所 以 使 用 起 来 比 Maven 稍 显 复杂 ， 相 反 













































































































































































































































































b 正 因为 可 以 定义 build 顺序 ， 所 以 非常 灵活 ， 在 Java 的 世界 中 被 广 
泛 使 
Maven Java 编写 的 项 目 管理 工具 。 用 pom.xml 文件 来 定义 build。Maven 





是 根据 CoC ( Convention over Configuration， 惯 例 优先 原则 ) 所 制作 
的 工具 ， 因 此 只 要 符合 Maven 的 规则 ， 就 很 少 需 要 对 build 进行 额外 
的 定义 。 反 之 ， 和 Ant 相 比 灵活 性 要 差 了 些 。 另 外 ，Maven 作为 项 
管理 工具 ， 除 了 build 以 外 还 具有 项 目 网 站 的 生成 、 测 试 的 执行 以 及 部 






























































































































































Gradle Gradle 是 近年 来 Java 界 比较 受 关注 的 新 build 工具 。 它 并 非 使 
Java， 而 是 用 名 为 Groovy 的 JVM ( Java Virtual Machine ) 上 运行 的 
千本 语言 编写 的 。 配 置 也 可 以 使 用 Groovy 编写 ， 比 XML 可 读 性 强 、 
度 高 。 还 可 以 只 使 用 Gradle 进行 依赖 关系 的 管理 *。 如 果 觉 得 Ant 
过 于 复杂 ，Maven 又 缺乏 灵活 性 ， 可 以 考虑 使 用 Gradle 作为 解决 这 两 
个 问题 的 build 工具 

Rake Ruby 编写 的 build 工具 。 使 Ruby 编写 的 配置 文件 Rakefile。 随 着 
Ruby on Rails 的 普及 ， 以 及 以 Chef 和 Capistrano 为 代表 的 服务 器 构 
建 自动 化 工具 的 普及 ，Rake 开始 被 广泛 使 




















































































































































































































































































































当然 ， 如 果 无 论 如 何 现 有 的 工具 都 不 可 用 的 话 ， 也 可 以 用 shell 脚 
本 或 其 他 熟悉 的 语言 自行 编写 build 脚本 ， 但 这 里 并 不 推荐 这 样 做 。 多 
数 情况 下 使 用 表 5.1 中 的 build 工具 都 应 该 能 够 满足 需求 。 并 且 如 果 使 用 
的 是 全 栈 式 ( full stack ) Web 应 用 程序 框架 的 话 ， 有 的 框架 也 会 自 带 
build 工具 。 

无 论 使 用 哪 一 款 工具 ， 重 要 的 都 是 要 具备 无 论 谁 在 什么 时 候 进 
提交 ，build 所 需 的 处 理 都 能 动 进行 这 样 的 机 制 。 
















































































Google 的 JavaScript 引擎 。 

实际 上 其 内 部 包含 了 IVy， 由 IVy 进行 依赖 关系 的 管理 。 

Chef 和 Capistrano 都 是 由 Ruby 编写 的 工具 ， 和 同样 可 以 用 Ruby 来 定义 build 的 
Rake 配合 度 较 好 。 因 此 多 数 的 Chef 和 Capistrano 的 任务 都 是 由 Rake 来 编写 的 。 
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e@…… 测试 代码 


CI 中 的 build 工作 并 不 是 仅仅 将 代码 编译 一 下 就 结束 了 。 执 行 测试 ， 
持续 地 确认 应 用 程序 的 正确 性 也 是 非常 重要 的 。 通 过 测试 来 确保 程序 的 
正确 性 就 不 必 担 心 退化 的 发 生 ， 能 够 大 胆 地 添加 新 功能 和 进行 代码 重 
构 ， 还 能 够 加 快 开发 速度 、 提 高 产品 质量 。 用 于 编写 测试 代码 的 框架 的 
相关 内 容 将 稍 后 讲解 。 












































当然 ,执行 CI 需要 相应 的 工具 。CI 工具 是 将 版 本 管理 系统 和 代码 、 
build 工具 组 合 起 来 ， 持 续 地 进行 集成 作业 的 工具 。 如 果 仅 仅 是 执行 自动 
build、 自 动 测试 的 话 ， 不 使 用 CI 工具 也 可 以 进行 。 但 通过 利用 CI 工具 
的 各 类 功能 ， 能 够 解决 很 多 问题 ， 比 如 自动 化 测试 何 时 进行 ， 执 行 的 结 
果 如 何 显示 和 通知 ，build 结果 和 版 本 管理 系统 、 缺 陷 管 理 系统 之 间 的 可 
追溯 性 如 何 确保 等 。 











































































































5.1.5 ”编写 测试 代码 所 需 的 框架 


写 测 试 代码 所 需 的 框架 有 以 下 两 种 。 








@ 测试 驱动 开发 ( TDD ) 的 框架 
@ 行为 驱动 开发 ( BDD ) 的 框架 


@…… 测试 驱动 开发 (TDD ) 的 框架 


即 实现 测试 驱动 开发 ( Test Driven Development，TDD ) 所 需 的 框架 。 

在 编写 应 用 程序 的 代码 之 前 ， 为 了 确认 需求 先 编写 测试 代码 〈test 
first )， 然 后 再 编写 符合 测试 代码 的 应 用 程序 代码 ,这样 的 手法 就 是 
TDD。 这 也 是 极限 编程 ( XP ) 实践 的 一 种 。 上 有 具有 代表 性 的 测试 驱动 开 
发 框架 有 Java 的 JUnit 和 TestNG “等 ,还 有 为 数 众多 的 各 类 语言 的 xUnit 



























































OD http:/junit.org/ 
@ http://testng.org/ 
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系列 框架 。 
例如 JUnit 的 情况 下 ， 对 于 Sample 类 的 getName () 函数 ， 可 以 
像 下 面 这 样 编写 测试 代码 。 


public class SampleTest { 
@Test 
public final void testSamplegetNameIsTakafumi() { 

















Sample sample = new Sample(); 
assertThat (sample.getName (), is("Takafumi")); 
} 
} 

















这 些 xUnit 系列 框架 的 特征 是 : 通过 编写 测试 用 例 ， 确 认 测 试 对 
象 类 以 及 方法 的 动作 的 正确 性 。 换 言 之 ， 也 可 以 理解 为 根据 测试 代码 
来 设计 类 的 API。 这 个 特征 和 接 下 来 的 行为 驱动 开发 工具 形成 了 很 好 的 
对 照 。 


一 



























































@…… 行 为 驱动 开发 ( BDD ) 的 框架 

从 测试 驱动 开发 发 展 而 来 ， 近 年 来 逐渐 流行 起 来 的 便 是 行为 驱动 开 
发 ( Behavior Driven Development，BDD )。BDD 和 TDD 一 样 都 是 最 先 
编写 测试 代码 。 

和 TDD 的 不 同 之 处 在 于 ，TDD 是 针对 程序 的 API 编写 测试 ， 而 
BDD 则 是 接近 于 需求 说 明 的 编写 方法 。 如 同 其 名 字 一 样 ，BDD 着 眼 于 
程序 的 行为 。 其 方式 是 在 需求 确定 后 编写 应 用 的 代码 ， 所 以 与 TDD 的 
测试 优先 相对 ，BDD 可 以 说 是 需求 优先 ( spec first )。 

BDD 的 代表 性 框架 有 Ruby 的 RSpec" 和 Cucumber 、JavaScript 的 
Jasmine”、Scala 的 Specs2 等。 其 他 还 有 各 个 语言 所 对 应 的 xSpec 系列 的 
框架 。 男 外 ，Cucumber 方面 ， 对 Ruby 之 外 的 各 语言 的 支持 也 在 正式 发 
布 中 。 

例如 Cucumber 面向 Java 实现 的 Cucumber-jvm 中 ， 在 名 为 sample. 

































































http://rspec.info/ 
http://cukes.info/ 
http:/jasmine.github.io/ 


昌 斩 所 口 


http:/Specs2.org/ 
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feature 的 文件 中 用 自然 语言 如 下 这 样 描述 需求 。 


#language: ja 

特征 ( feature ) : Sample 功 能 
场景 ( scenario ) ; 确认 Sample 类 中 的 Name 属 性 
前 提 : new Sample 类 
结果 getName 的 返回 值 应 该 为 “Takafumi” 




















接着 如 下 定义 空 的 测试 类 。 


import org.junit.runner.RunWith; 
import cucumber.junit.Cucumber; 


@RunWith (Cucumber.class) 
@Cucumber .Options (format={"pretty"}) 
public class SampleTest { 


} 


定义 好 之 后 ， 像 通常 的 JUnit 一 样 执 行 上 述 文件 ， 标 准 输出 会 显示 
如 下 代码 。 


You can implement missing steps with the snippets below: 


@ 前 提 ("^: new Sample 类 $") 

public void new Sample 类 () throws Throwable { 
// Express the Regexp above with the code you wish you had 
throw new PendingException(); 











@ 结 果 ("^: getName 的 返回 值 应 该 为 \”([^\" ]*)\” $") 

public void getName 应 该 为 (String arg name) throws Throwable { 
// Express the Regexp above with the code you wish you had 
throw new PendingException(); 





CN 


这 就 是 用 自然 语言 描述 的 sample.feature 所 对 应 的 测试 代码 的 锥 形 。 
将 这 段 雏形 代码 复制 粘贴 到 刚才 空 的 测试 类 中 并 加 以 实现 。 本 例 的 具体 
实现 如 下 。 

之 后 只 需要 向 sample.feature 用 自然 语言 添加 需求 并 执行 测试 即 可 。 
向 sample.feature 中 添加 的 需求 如 果 没 有 在 测试 类 中 进行 实现 的 话 ， 就 
会 在 标准 输出 中 显示 代码 ， 提 示 要 添加 新 的 测试 函数 。 

像 这 样 根 据 自然 语言 描述 的 需求 (行为 的 定义 ) 来 编写 测试 代码 ， 
这 就 是 Cucumber 的 方式 。 
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这 些 处 理 在 技术 上 和 JUnit 并 没有 太 大 的 变化 ， 区 别 仅 在 于 测试 的 
编写 方式 和 执行 方式 。 虽 说 如 此 ， 也 正 是 因为 这 些 不 同 之 处 ，Cucumber 
才 使 验收 人 员 能 够 用 自然 语言 编写 需求 规格 。 

这 次 用 Cucumber 试 着 写 了 Sample 类 的 单元 测试 。 本 来 Cucumber 
是 用 来 定义 行为 并 进行 测试 的 工具 ， 所 以 一 般 多 用 于 结合 多 个 类 的 测 
试 。 也 就 是 说 ，Cucumber 原本 是 用 于 确保 集成 测试 和 用 户 验 收 测试 的 。 
这 次 是 为 了 对 比 TDD 框架 和 BDD 框架 而 特意 编写 了 相同 的 测试 。 

大 多 数 的 需求 都 能 用 接近 自然 语言 的 DSL (Domain Specific 
Language ) “来 编写 , 这 是 BDD 的 特点 。 使 用 近似 于 自然 语言 的 DSL 来 描 
述 需 求 ， 然 后 直接 将 其 用 于 测试 。BDD 是 以 让 负责 需求 定义 的 人 或 客 
户 等 立场 上 接近 于 产品 利益 相关 者 的 人 也 能 够 编写 需求 为 目的 而 设计 
的 ， 这 也 是 其 特征 。 与 之 相对 ，TDD 框架 的 机 制 是 促进 API 的 设计 。 










































































5.1.6 主要 的 Cl 工具 








CI 工具 数量 众多 ， 具 有 代表 性 的 有 以 下 两 个 。 


® Jenkins2 


@ TravisCl® 


@.……. Jenkins 





原名 为 Hudson 的 Jenkins 如 今 可 以 毫 不 为 过 地 说 是 CI 工具 事实 上 
的 标准 。 全 世界 的 项 目 都 在 使 用 Jenkins ( 图 5.4 )。 
GD 和 Java、Ruby 这 样 通用 的 程序 不 同 ，DSL 是 为 了 解决 特定 领域 的 问题 而 设计 的 


语言 ， 因 此 也 称 为 领域 特定 语言 。 
http:/jenkins-ci.org/ 











https://travis-ci.org/ 

原本 是 Sun Microsystems 旗下 的 作为 OSS 开发 的 名 为 Hudson 的 工具 。 由 于 
Oracle 收购 Sun Microsystems 而 产生 的 商标 问题 ， 开 源 社区 在 2010 年 对 Hudson 进 
行 了 fork (复制 代码 并 作为 另外 的 项 目 重 新 开始 )， 并 将 其 改名 为 Jenkins。 之 后 
几乎 所 有 Hudson 的 提交 者 都 转移 到 了 Jenkins 项 目 ，Oracle 也 因为 无 法 继续 维护 
Hudson 项 目 ， 最 终于 2012 年 末 将 其 转交 给 了 Eclipse 基金 会 。 后 来 就 几乎 没有 向 
Hudson 项 目的 代码 提交 了 ， 而 Jenkins 则 作为 名 副 其 实 的 活路 着 的 项 目 留 了 下 来 。 


©OON 
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图 5.4 Jenkins 








An extendable open source continuous integration server 


BLOG CONNECT BUG TRACKER WIKI CI TUTORIALS ARCHIVES DONATION ABOUT 
Download Jenkins 
Release Long-Term Support Release 
Meet Jenkins 
Find out what Jenkins is and get started. Java Web Archive (.war) 
Latest and greatest (1.515) 
changelog | past releases | RC 
upgrading from Hudson? 
Or native package 
Use Jenkins .| 
See how to get more out of your Jenkins. Windows 





明 UbuntjlDebian 


ES 
恬 aa 人 0 
[A Eeeasp 
在 Jenkins 之 前 还 有 过 Continuum 和 Cruise Control 等 ， 几 乎 都 已 经 
没有 存在 感 了 。 从 Jenkins 被 称 为 事实 上 的 标准 可 以 看 出 ，Jenkins 具备 
丰富 的 功能 并 且 安 装 简便 。Jenkins 的 相关 内 容 将 在 5.4 节 进 行 讲解 。 

















@…… TravisCl 





作为 通用 的 CI 工具，Jenkins 可 以 说 是 一 个 非常 不 错 的 选择 ， 但 最 
近 使 用 TravisCI 的 情况 也 开始 逐渐 增加 (图 5.5 )。TravisCI 是 GitHub 提 
供 的 配套 的 CI 工具。 虽然 非 GitHub 的 项 目 无 法 使 用 ,但 它 设置 简单 ， 



































只 需要 5 分 钟 左 右 就 能 够 开始 CI。 


图 5.5 TravisCl 












39 Curent | BundHlstoy 。 PulRequests | BranchSummary 次 ~ 
@ mongohHe 
Build Message Commit Duration 
i 
lia/ mn 7571 Addnote about decorator oading In Engines guide. ab28bat masten 2hrs 43 min 46 seo 
© 2 hrs 43 min 46 sec, aday ago 
7570 Restore rescue block for when IMis enabled S799cfat9-2-stabl) C6hrs54min10seo 
Sponsors 
pe 9 © 7569 。 Merge pul request #10745 from T101885 (8-2-stable)} C5hrs37 min27 sec 
tet arunagw/build_fix ruby187 Cloudant: grow into your data 
Lan shout a monthag Iayer, not out of It 
©7568 Mergepullrequest#10713 from 293990 (3-2-stable) 3hrs 48 min 28 sec 
senny/10693_fx_prmary_key_option_on_has_man Zendesk: Love your helpdesk 
© prograils/railspeople 30 Wn 
@ 4 min 42 sec, about a month ago ©1567 Mergepull request#10713from dB7ee0a (4-0-stable) 2hrs 44 min 36 sec Mindmatters: Software fOr 
senny/10693_fx primary_key_option_on has many Menschen 
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TravisCI 的 功能 虽然 并 不 多 ， 但 就 进行 单元 测试 和 集成 测试 来 说 已 
经 足够 了 。 并 且 还 能 够 和 GitHub 密切 关联 ， 使 GitHub 项 目 最 近 的 build 
状态 一 日 了 然 (图 $.6 )。 


5.6 用 图 标 表示 build 状态 
Code Status 


在 合并 Pull Request 之 前 能 够 自动 执行 测试 ， 这 是 TravisCI 的 特 
长 "。 借助 上 述 功能 ,就 能 够 避免 在 合并 Pull Request 之 后 才 发 现 build 出 
错 的 事态 ， 使 得 高 效 的 团队 开发 成 为 可 能 。 

以 前 TravisCI 只 能 用 于 公开 的 代码 库 ， 从 2013 年 开始 私有 的 代码 
库 也 能 使 用 了 。 因 此 如 果 在 使 用 GitHub 的 话 ，TravisCI 可 以 说 是 值得 考 
虑 的 工具 。 




























































































中 顺便 提 一 下 ，Jenkins 通过 使 用 插件 也 能 够 实现 同样 的 功能 。 这 部 分 内 容 将 在 5.4 
节 进 行 讲解 。TravisCI 默认 支持 Pull Request 的 CI， 这 点 非常 方便 。 
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5.2 build 工具 的 使 用 方法 








本 节 将 对 实现 CI 所 需 的 build 工具 的 使 用 方法 进行 简单 的 讲解 。 
虽说 build 自动 化 是 实现 CI 所 必 不 可 少 的 ， 但 是 没有 实现 build 自 
动 化 的 开发 现场 并 不 在 少数 。 像 Java 这 样 比较 多 地 使 用 IDE ( Integrated 
Development Environment， 集 成 开发 环境 ) 进行 开发 的 现场 ， 特 别 
普遍 。 

IDE 将 编译 (compile )、build、 程 序 的 启动 ， 到 测试 的 执行 等 所 有 
流程 进行 了 半自动 化 封装 ， 用 起 来 的 确 非 常 方便 。 但 几乎 所 有 的 操作 都 
要 通过 GUI 来 设置 ， 在 实施 build 自动 化 时 反而 会 成 为 阻碍 。 与 之 相对 ， 
使 用 脚本 语言 的 开发 现场 由 于 缺乏 IDE 的 支持 ， 比 较 多 见 的 是 从 一 开始 
就 使 用 build 工具 来 实施 自动 化 。 

还 有 一 些 开 发 现场 是 开发 人 员 用 IDE 进行 build， 人 负责 build 的 人 员 
和 Ant 这 样 的 工具 重新 build 后 再 实施 QA 和 部 署 。 这 样 的 做 法 会 造成 
开发 时 和 QA 时 的 build 方法 产生 差异 ， 所 以 应 该 避免 这 样 的 做 法 。 
确保 开发 人 员 、 测 试 人 员 、 负 责 build 的 人 员 、 负 责 发 布 的 人 员 都 
能 使 用 相同 的 方法 进行 build， 这 对 于 CI 的 实现 是 非常 重要 的 。 因 此 开 
发 人 员 也 应 该 从 一 开始 就 使 用 build 工具 来 构建 开发 环境 。 

build 工具 种 类 繁多 ， 请 根据 使 用 的 语言 以 及 开发 环境 来 选择 合适 的 
build 工具 。 
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5.2.1 新 建 工 程 的 情况 





这 里 以 Java 为 例 进行 讲解 。 
开始 新 的 工程 ， 使 用 Maven 等 工具 从 零 建立 工程 的 雏形 。 

Maven 是 根据 CoC ( Convention over Configration， 惯 例 优先 原则 ) 
的 思想 而 设计 的 build 工具 。 其 目录 的 构成 等 都 有 明确 的 规定 ， 能 够 高 
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效 地 进行 build。 Maven 的 安装 方法 请 参考 相关 网 站 "或 书籍 “。 撰写 本 书 
时 (2014 年 3 月 ) Maven 的 最 新 版 本 是 3 。 

Maven 工程 骏 形 的 建立 方式 有 两 种 : 从 命令 行 建立 和 通过 IDE 的 
GUI 建立 。 

Maven 还 是 一 款 能 够 和 Eclipse 以 及 IntelliJ IDEA 等 IDE 紧密 结合 
的 工具 ， 能 够 通过 IDE 的 GUI 进行 设置 。 但 Maven 原本 是 作为 命 令 行 
具 设 计 的 ， 因 此 应 该 尽 可 能 地 通过 命令 行 来 调用 ， 这 样 会 省 去 很 多 麻 






































HH 








这 里 将 简单 介绍 从 命令 行 建 立 工 程 锥 形 到 导入 Eclipse 的 过 程 。 





@…… 建 立 工程 纵 形 
Maven 安装 完成 后 ， 执 行 以 下 命令 来 建立 工程 雏形 “。 


$ mvn archetype:generate 


稍 许 等 待 后 会 出 现 如 下 使 用 何 种 工程 雏形 的 询问 。 本 书 执笔 时 共有 
914 种 秩 形 可 供 选 择 。 这 里 使 用 Maven 建议 的 最 基本 的 344 号 工程 骏 
形 。 确定 后 按 下 回 车 键 。 


略 
913 : remote 一 tk.skuro:clojure-maven-archetype (A simple Maven archetype 
for Clojure) 









































914: remote 一 uk.ac.rdg.resc:edal-ncwms-based-webapp (-) 
Choose a number or apply filter (format: [groupId:]artifact1id, case 
sensitive contains): 344: 


接着 会 询问 锥 形 的 版 本 、groupId、artifactld 等 必要 的 信息 。 


Choose org.apache.maven.archetypes:maven-archetype-quickstart version: 
1 TO0=alpha=l 








D http://maven.apache.org/ 

©® Apache Maven 3 Cookbook，, Srirangan 著 ，Packt Publishing，2011 

@@ 国内 的 相关 书籍 以 及 网 站 上 的 内 容 几 乎 都 是 关于 Maven3 的 ， 这 点 请 注意 。Maven3 
最 大 限度 地 考虑 了 和 Maven2 之 间 的 兼容 性 ， 因 此 在 Maven2 上 能 够 运行 的 在 
Maven3 上 基本 都 能 运行 ,但 也 有 例外 。 还 需要 注意 Maven1，Mavenl 和 Maven2、 
Maven3 并 不 兼容 。 参 考 网 络 上 的 资料 时 ， 请 一 定 要 注意 Maven 的 版 本 。 译 者 注 

@ http://www.jetbrains.com/idea/ 

@ Maven 会 首先 从 互联 网 上 下 载 必要 的 模块 ， 并 build 执行 命令 的 环境 。 因 此 第 一 


次 启动 Maven 时 会 执行 下 载 和 build， 需 要 等 待 一 段 时 间 。 
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2: 1.0-alpha-2 

3 1.0=-alpha=3 

4: 1.0-alpha-4 

Se 

lil 

Choose a number: 6: 

Define value for property !groupId': : com.gmail.ikeike443 
Define value for property 'artifactId'!: : sample 

Define value for property 'version': 1.0-SNAPSHOT: : 

Define Value for property 'package': com.gmail.ikeike443: : 








首先 要 选择 maven-archetype-quickstart 的 版 本 ,使 用 最 新 


的 版 本 ( 这 里 是 6:1.1 )， 然 后 按 下 回 车 。 
groupId 会 指定 区 分 团队 或 项 目 等 多 个 产品 的 Id。 通常 将 所 属 团 队 
的 域名 等 用 点 
artifactId 为 项 目 自身 的 名 字 ， 请 根据 项 目 设置 合适 的 名 字 。version 





可 党 











ll 


























分 割 并 倒序 显示 。 这 里 使 用 笔者 自己 的 邮件 地 址 。 














这 次 直接 使 用 默认 值 即 可 。 按 下 回 车 。package 通常 可 以 和 groupId 相 
， 因 此 使 用 默认 值 ， 按 下 回 车 确认 即 可 。 





= 

















最 后 是 配置 内 容 的 确认 ， 没 有 问题 的 话 请 按 下 [YM 键 。 


Confirm properties configuration: 

















.gmail.ikeike443 


sample 


: 1.0=-SNAPSHOT 


groupId: com 
lieriaeerls 
version 
package: com 
ee 


.gmail.ikeike443 


若 输 出 BUILD SUCCESS， 就 算 成 功 了 。Maven 会 生成 名 为 sample 
的 目录 ， 进 入 该 目录 。 


$ cd sample 


可 以 确认 sampble 目 录 下 生成 了 如 下 目录 结构 。 


$ tree 








gmail 
[一 一 ikeike443 
App.java 
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eese 
[一 java 
eon 


-一 一 gmail 


[一 一 ikeike443 
Cane ava 


11 directories, 3 files 


src/main/java 是 程序 代码 的 目录 。src/test/java 是 测试 代码 的 目录 。 
像 这 样 ，Maven 能 够 将 程序 代码 和 测试 代码 存放 在 同一 工程 的 不 同 目录 
下 。 请 注意 这 里 的 “同一 工程 ”是 重点 。 

为 了 有 效 地 执行 CI， 将 应 用 程序 代码 和 测试 代码 一 同 置 于 版 本 管理 
系统 中 是 非常 重要 的 。Maven 就 是 一 款 能 够 简单 地 实现 上 述 需求 的 工 
具 。 其 他 的 语言 也 有 类 似 的 工具 ， 可 以 自行 选择 合适 的 工具 。 

Maven 的 构成 如 表 5.2 所 示 “。 















































表 5.2 Maven 的 构成 
























































目录 /文件 说 明 

pom.xml 工程 的 build 定义 

src/main/java 程序 代码 

src/main/resources 程序 资源 

src/main/webapp WEB-INF、JSP 文件 等 Web 相关 的 资源 
src/test/java 测试 代码 

src/test/resources 仅 供 测试 使 用 的 资源 

target Class、jar、 测 试 结果 等 文件 














e…… 依赖 关系 的 定义 

















第 3 章 中 已 经 提 到 过 ， 通 过 在 pom.xml 中 使 用 <dependencies> 
标签 定义 依赖 关系 ，Maven 会 处 理 所 依 赖 库 的 传递 依赖 ， 将 所 需要 的 库 
添加 到 classpath 中 。 

例如 本 次 的 工程 稚 形 中 ， 像 下 面 这 样 定 义 junit 的 依赖 关系 。 


<dependencies> 

















( Maven 还 可 以 用 于 Java 以 外 的 JVM 语言 的 build。 这 时 Maven 一 般 会 在 Java 目 
录 的 同一 层次 中 建立 以 groovy、scala、jruby 等 语言 命名 的 目录 。 
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<dependency> 
<groupId>junit</groupId> 
ametactlo nt Nant aetl 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 

</dependencies> 








这 里 定义 了 JUnit3.8.1， 














当时 的 最 新 版 本 。 


那么 就 让 我 们 来 试 着 编译 一 下 。 执 行 如 下 命令 。 


$ mvn compile 


编译 后 Maven 会 在 target 目录 下 生成 Class 文件 。 





@.……. 执行 测试 





六 


这 次 我 们 来 试 着 执行 测试 。 虽 然 AppTest.java 依赖 了 junit， 但 因为 











已 经 在 pom.xml 中 定义 了 依赖 关系 ， 所 以 可 以 直接 执行 测试 。 














mvn test 

NFO] Scanning for projects... 

NFO] 

NFO] ----------------------------------------------------------- 


a 


NEOW =- 





Running com.gmail.ikeike443.AppTest 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.049 sec 


Results : 


este run lI Ealluress on Errore 0 Skipped 0 


INFO] Total time: 13.282s 
INFO] Finished at: Thu May 23 18:06:32 JST 2013 
INFO] Final Memory: 15M/145M 
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Maven 会 自动 处 理 对 JUnit 的 依赖 ， 编 译 代码 并 执行 测试 。 

测试 结果 会 在 target/surefire-reports/ 目 录 下 生成 ， 以 文 
本 文件 和 XML 文件 两 种 形式 存储 。 这 个 XML 文件 在 Jenkins 生成 报告 
时 会 起 到 作用 。 

使 用 Maven 插件 ， 测 试 结果 报告 还 可 以 自 定义 为 HTML 等 各 类 形 
式 ， 这 方面 的 内 容 请 参考 相关 资料 。 









































人 导入 Eclipse 


最 后 让 我 们 试 着 导入 Eclipse。 运 行 以 下 命令 即 可 生成 Eclipse 专用 

的 .classpath 和 .project 文件 。 
§ mn eclipse:eclipse 

只 要 从 Eclipse 的 菜单 导入 生成 的 .project 文件 ， 就 可 以 用 Eclipse 
打开 Maven 工程 了 。IntelliJ IDEA 和 Netbeans" 也 有 支持 同样 功能 的 插 
件 ， 可 以 根据 需要 使 

相反 ， 通 过 IDE 的 GUI 也 可 以 初始 化 Maven 的 工程 。Eclipse 从 
3.7 版 (Indigo ) 开始 默认 支持 Maven”。 基 本 上 通过 新 建 工程 向 导 就 能 够 
建立 Maven 工程 。 根 据 向 导 的 提示 ， 一 步 一 步 地 执行 即 可 。 再 重复 一 
下 ， 充 分 使 用 命令 行 对 于 有 效 地 执行 CI 是 非常 重要 的 ， 因 此 尽 可 能 地 
通过 命令 行 来 使 用 Maven。 

















o 





5.2.2 为 已 有 工程 添加 自动 build 功能 








新 建 工程 时 ， 使 用 Maven 这 样 的 CoC 的 build 工具 来 初始 化 工程 是 
最 简单 的 ， 但 同样 存在 已 有 的 没有 使 用 build 工具 的 工程 。 这 样 的 情况 
下 ， 如 果 是 Java 工程 ， 可 以 使 用 Ant 进行 build。 

Ant 不 像 Maven 这 样 有 着 固定 的 规则 。 另 外 ， 因 为 Ant 运行 在 JVM 
之 上 ， 所 以 有 着 不 同 于 Make 依赖 于 执行 环境 的 特点 。 从 目录 的 构成 到 
依赖 关系 的 处 理 、 测 试 的 执行 都 可 以 自由 地 进行 定义 。 因 此 根据 已 有 的 
























































D https://netbeans.org/ 
@) 3.6 版 之 前 的 版 本 需要 另行 安装 名 为 m2eclipse 的 插件 。 
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工程 编写 build.xml 即 可 。 

Ant 默认 定义 有 compile、test、package 这 样 的 任务 ， 可 以 利 
j 这 些 任务 快速 地 进行 build。 

但 是 Ant 没有 默认 进行 依赖 关系 管理 ， 因 此 推荐 使 用 Ivy 这 款 工 
具 。Ivy 是 将 Maven 的 依赖 关系 管理 功能 独立 出 来 的 工具 ， 可 以 结合 
Ant 使 用 。 












































5.2.3 build 工具 的 总 结 





为 了 实施 CI， 首 先 实 现 build 的 自动 化 是 非常 重要 的 ， 可 以 说 是 必 
不 可 少 的 。 这 里 以 Java 工程 为 例 ， 简 单 地 介绍 了 build 工具 的 使 用 方法 。 
新 建 工程 请 使 用 Maven， 已 有 工程 请 使 用 Ant， 来 开始 实施 build 自 
动 化 。 也 可 以 使 用 Gradle。 不 管 选择 哪 款 工具 ， 实 现 build 的 自动 化 是 
非常 重要 的 。 

利用 Java 开发 Web 应 用 程序 的 情况 下 ， 通 过 结合 Maven 或 Ant 对 
jetty、Struts2、Spring、Hibernate 这 样 的 servlet 容器 或 各 类 框架 进行 
build， 可 以 实现 build 的 自动 化 。 

另外 也 可 以 使 用 全 栈 式 的 Play Framework 作为 Java 的 Web 应 用 程 
序 框架 。Play Framework 虽然 不 使 用 Maven 和 Ant， 但 默认 支持 自动 化 
编译 以 及 自动 化 测试 的 机 制 ， 因 此 是 非常 适合 于 CI 的 框架 。 






































































































































D http://ant.apache.org/ivy/ 
©® http:/www.playframework.com/ 
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5.3 测试 代码 的 写法 





自动 化 测试 可 以 说 是 CI 的 重点 。 如 同 我 们 在 第 2 章 问 题 5 中 所 见 ， 
如 果 不 持续 地 执行 自动 化 测试 ， 就 无 法 发 现 不 知 不 觉 中 发 生 的 退化 。 

同样 还 有 问题 7， 因 为 缺乏 测试 ， 所 以 无 法 进行 重 构 。 通 过 实施 
CI， 构 筑 起 能 够 时 常 自动 执行 测试 的 环境 ， 那 样 就 应 该 有 信心 进行 重 构 
了 。 从 长 期 来 看 也 能 够 有 效 地 提高 开发 质量 。 随 着 质量 的 提高 ， 添 加 新 
功能 的 速度 也 会 相应 地 加 快 ， 并 最 终 向 客户 提供 更 多 的 价值 。 
虽说 CI 的 自动 化 测试 能 有 效 提 高 开发 速度 及 质量 ， 但 为 了 执行 自 
动 化 测试 ， 必 须 编 写 测试 代码 。 

请 使 用 之 前 叙述 过 的 TDD 或 BDD 等 测试 框架 来 编写 测试 代码 。 还 
有 一 些 Web 应 用 程序 框架 原生 自 带 测试 框架 。 







































































5.3.1 作为 CI 的 对 象 的 测试 的 种 类 


一 般 来 说 软件 测试 可 进行 如 下 分 类 "。 





e@ 单元 测试 ( Unit Test，UT ) 

@ 集成 测试 ( Integration Test，IT ) 

@ 用 户 验 收 测试 ( User Acceptance Test，UAT ) 
@ 回归 测试 








其 中 哪些 应 该 作为 CI 的 对 象 呢 ? 答案 是 全 部 。 当 然 测试 的 搭建 是 
一 项 耗费 成 本 的 工作 ， 因 此 要 根据 项 目的 状况 ， 仔 细 考 虑 希望 得 到 的 测 
试 效果 和 成 本 之 间 的 平衡 。 但 是 如 果 成 本 允许 的 话 ， 还 是 应 该 将 上 述 所 
有 测试 都 作为 CI 的 对 象 。 


























中 除 此 之 外 还 有 性 能 测试 、B 用 户 测试 等 各 类 测试 ， 这 里 就 不 提 了 。 
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本 章 对 主要 由 开发 人 员 编写 的 单元 测试 和 集成 测试 的 CI 实施 进行 
说 明 。 用 户 验 收 测试 的 相关 内 容 将 在 第 7 章 进行 讲解 。 而 利用 CI 持续 
地 执行 测试 可 以 说 就 是 回归 测试 。 


























5.3.2 ” 何 时 编写 测试 





何 时 编写 测试 代码 ? 根据 时 间 以 及 项 目 状 况 的 不 同 ， 需 要 注意 的 事 
项 也 有 所 不 同 。 


人 新 建 工 程 的 情况 


在 5.2 节 中 已 经 讲解 过 ， 新 建 工 程 时 ， 请 将 测试 框架 和 Maven 等 
build 工具 一 起 导入 。 也 可 以 使 用 Ruby on Rails 或 Play Framework 等 全 
栈 式 Web 应 用 程序 框架 。 每 次 新 建 类 或 添加 方法 时 ， 都 要 注意 将 测试 代 
码 一 同 添加 ， 并 一 同 提交 到 版 本 管理 系统 。 
ij 写 测试 代码 ， 从 短期 看 来 ， 很 多 人 担心 会 影响 开发 速度 。 这 样 的 
想法 是 不 正确 的 。 在 工程 代码 的 基础 上 还 要 编写 测试 代码 ， 这 的 确 会 耗 
费时 间 ， 因 此 仅 从 完成 编码 的 时 间 来 看 的 确 是 延长 了 。 但 是 编写 测试 代 
但 是 开发 人 员 必 须 进行 的 重要 工作 ， 因 为 开发 人 员 的 工作 并 不 是 只 要 完 
成 编码 就 结束 了 ， 而 是 要 向 顾客 提供 价值 。 换 言 之 ， 就 是 要 编写 按照 预 
期 运行 的 软件 ， 提 供 没 有 退化 的 产品 。 

使 用 测试 优先 或 者 需求 优先 的 开发 方式 ， 就 能 够 在 编写 代码 的 同时 
确认 程序 是 否 正常 运行 ， 进 而 使 返工 减少 ， 开 发 的 整体 速度 加 快 。 
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e@…… 已 有 工程 中 没有 测试 的 情况 


很 多 已 有 的 工程 都 没有 实施 自动 化 测试 。 根 据 工程 规模 的 不 同 ， 应 
该 采取 的 措施 也 有 所 差异 ,但 还 是 应 该 尽 可 能 地 为 能 够 测试 的 部 分 编写 
测试 代码 。 

但 未 经 测试 的 代码 往往 是 无 法 编写 或 者 很 难 编写 测试 的 代码 。 类 没 
有 得 到 合理 地 职责 分 割 ， 与 RDBMS 或 外 部 系统 的 API 紧密 耦合 ， 不 启 
动 整个 程序 就 无 法 确认 动作 ， 这 些 都 是 常 有 的 事情 。 在 这 样 的 情况 下 ， 












































图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 








166 | 第 5 章 CI (持续 集成 ) 


首先 请 编写 从 最 外 侧 确保 程序 动作 的 测试 代码 。 这 里 的 “最 外 侧 ” 是 指 
用 户 所 看 到 的 用 户 界面 。 

Web 应 用 程序 方面 ， 有 一 款 名 为 Selenium 的 模拟 浏览 器 动作 并 进行 
测试 的 著名 工具 。 首 先 可 以 使 用 Selenium 编写 针对 浏览 器 用 户 界面 的 用 
户 验 收 测试 ， 并 实施 自动 化 。 重 复 上 述 测试 即 等 同 于 实施 了 回归 测试 ， 
这 样 就 不 必 再 担心 退化 的 发 生 ， 能 够 放心 地 对 代码 进行 重 构 。 在 借助 
Selenium 确保 对 外 的 用 户 界面 不 变 的 基础 上 ， 内 部 逐渐 转变 设计 ， 分 割 
为 能 够 测试 的 类 。 这 样 既 能 逐渐 提高 质量 ， 添 加 新 功能 的 速度 也 会 相应 
加 快 。 

使 用 Selenium 进行 用 户 验 收 测试 的 相关 内 容 ， 会 在 第 7 章 进 行 详细 
讲解 。 



























































@…… 修改 bug 或 添加 新 功能 的 情况 


无 论 是 一 开始 就 编写 了 测试 代码 这 样 幸运 的 工程 ， 还 是 没有 测试 代 
码 这 样 翡 惨 的 遗留 工程 ， 都 会 在 修改 bug 或 者 增加 新 功能 时 添加 代码 。 
这 时 请 一 定 要 编写 测试 代码 。 修 改 bug 的 话 ， 可 以 仅 以 修改 的 函数 为 对 
象 添 加 数 行 测试 代码 。 千 里 之 行 始 于 足下 。 即 便 只 是 一 点 一 点 地 积累 测 
试 代码 ， 也 总 有 一 天 会 覆盖 全 体 代码 。 

编写 测试 代码 还 涉及 工程 的 文化 层面 。 也 就 是 说 ,缺乏 测试 的 工程 
是 没有 编写 测试 文化 的 工程 。 为 了 改变 这 样 的 文化 ， 实 际 编写 测试 代码 
并 展现 其 效果 是 最 好 的 办 法 。 因 此 在 修改 bug 或 添加 新 功能 时 请 一 定 
编写 测试 代码 。 
































5.3.3 ” 藉 手 的 测试 该 如 何 写 





为 了 对 和 RDBMS 或 外 部 系统 的 API 耦合 的 部 分 这 种 比较 难 测 试 的 
部 分 进行 测试 ， 这 里 介绍 一 些小 技巧 。 


。… 和 外 部 系统 有 交互 的 测试 
连接 RDBMS 等 数据 库 的 部 分 ， 或 者 调用 Twitter、Facebook 的 API 
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的 部 分 等 ， 编 写 依赖 于 应 用 程序 外 部 状态 的 测试 是 比较 困难 的 。 这 部 分 
的 测试 要 怎么 写 才 好 呢 ? 











@…… 使 用 mocking 框架 进行 测试 


关于 这 部 分 测试 ， 单 元 测试 基本 上 是 利用 模拟 对 象 (mock) 或 桩 程 
序 (stub) 进行 测试 的 。 

例如 ,可 以 使 用 名 为 Mockito "的 mocking 框架 来 模拟 连接 数据 库 的 
部 分 。 大 致 的 代码 如 下 所 示 “。 


// 检查 数据 库 中 的 用 户 的 年 龄 是 否 满 18 岁 
// 编写 Authrization 类 的 单元 测试 









































// 将 数据 库 连 接 对 象 转换 为 nock 对 象 

User mocked = mock (User.class) 

// 根据 测试 目的 设置 mock 对 象 的 返回 值 

when (mocked.getAge()) .thenReturn(16) ; 

// 在 测试 对 象 中 注入 mock 对 象 并 开始 测试 

Authorization auth = new Authorization (mocked) ; 
// 确认 年 龄 检查 的 结果 


assertThat (auth.proveAge(), is(false) 





















































mock、when、thenReturn 都 是 Mockito 提供 的 方法 。 这 里 建立 
User 类 的 mock 对 象 ， 在 该 对 象 的 getAge 方法 被 调用 时 ， 返 回 值 定义 为 
16。 这 里 不 再 做 更 详细 的 说 明 ， 上 述 测试 代码 的 写法 还 是 相当 直观 、 易 
懂 的 。Mockito 是 一 款 功 能 强大 的 mock 框架 ,详细 的 使 用 方法 请 参考 
相关 资料 。 

这 样 ， 本 来 不 得 不 根据 测试 用 例 来 修改 数据 库 值 的 地 方 ， 借助 
mock 框架 便 不 必 实 际 修改 数据 库 ， 使 用 mock 对 象 就 能 够 编写 测试 。 
虽然 没有 列举 示例 代码 ， 但 和 Web 服务 的 API 相关 的 部 分 同样 可 
以 使 用 Mockito 来 模拟 。 例 如 ， 可 以 为 连接 Web 服务 的 类 制作 mock， 
使 其 返回 固定 的 JSON 作为 响应 。 

CI 中 ， 由 于 同一 测试 要 持续 地 、 反 反复 复 地 执行 ， 因 此 无 论 执 行 几 
























































OD http:/mockito.org/ 

@) 这 里 的 示例 代码 非常 简单 。 在 实际 工程 中 编写 这 样 的 mock 的 测试 代码 时 ， 对 象 类 
中 获取 外 部 数据 的 部 分 需要 能 够 简单 地 替换 成 mock， 需 要 具备 DI (Dependency 
Injection ) 的 机 制 。DI 的 形式 多 种 多 样 ， 这 方面 可 以 参考 相关 资料 。 
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次 都 必须 返回 相同 的 结果 。 数 据 库 是 将 状态 持久 化 的 工具 ， 所 以 反复 执 
行 测试 的 话 ， 数 据 库 的 状态 会 发 生变 化 。 防 止 这 一 问题 的 方法 之 一 就 是 
mock。 如 前 所 述 ，mock 能 够 提高 单元 测试 的 效率 ， 不 仅 是 数据 库 关联 
的 测试 ， 调 用 外 部 Web 服务 API 的 测试 同样 可 以 使 

如 果 不 使 用 mock 框架 ， 也 可 以 在 每 次 进行 测试 时 启动 数据 库 、 建 
立 数 据 库 、CREATE 表格 、 加 载 数 据 ， 测 试 结束 后 再 将 数据 库 删 除 。 已 
经 存在 大 量 代 码 没 有 测试 的 情况 下 ， 添 加 mock 的 机 制 比 较 困 难 ， 因 此 
多 采用 上 述 方法 。 

例如 ， 在 使 用 Selenium 实施 用 户 验 收 测试 时 ， 比 起 使 用 mock, 使 
用 真正 的 数据 库 进行 测试 或 许 更 有 价值 。 用 户 验 收 测试 中 数据 库 连接 是 
和 否 成 功 本 身 也 是 需要 测试 的 项 目 之 一 ， 多 数 情况 下 ， 表 之 间 复 人 杂 的 状态 
迁移 也 需要 进行 测试 。 并 且 在 进行 用 户 验收 测试 时 ， 如 果 要 将 所 有 的 相 
关 对 象 都 mock 化 ,那么 所 涉及 的 数据 条 数 以 及 表 的 数量 实在 太 大 ， 实 
际 上 很 难 做 到 。 

这 样 的 情况 下 只 能 采取 在 每 次 测试 时 构建 并 删除 数据 库 的 方法 。 
于 这 样 的 处 理 非 常 费 时 ， 测 试 的 速度 也 会 由 此 变 慢 。 并 且 在 真实 的 数据 
库 上 建立 这 样 的 机 制 要 耗费 不 少 的 时 间 和 精力 “。 
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e…… 使 用 内 存 数据 库 进行 测试 


这 里 有 必要 考虑 使 用 一 款 名 为 H2 的 数据 库 。 它 是 用 Java 编写 的 轻 
量 级 的 数据 库 引 擎 ， 支 持 内 存 数 据 库 模 式 。 使 用 H2 能 够 使 得 重量 级 的 
数据 库 构 筑 处 理 变 得 轻便 ， 测 试 的 范围 也 得 到 了 相应 的 拓展 。 需 要 注意 
的 是 ，H2 无 法 支持 各 个 RDBMS 的 独特 的 检索 语法 ， 关 于 这 一 点 ， 可 
以 在 中 间 加 一 层 Hibernate 这 样 的 O/R 映射 工具 ， 来 吸收 各 个 数据 库 之 
间 的 差异 。 

现代 的 Web 应 用 程序 框架 应 该 能 够 根据 运行 时 的 配置 更 改 数 据 库 的 
连接 。 例 如 Play Framework 在 执行 测试 时 默认 使 用 H2 连接 数据 库 ”, 并 
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@ 这 样 的 情况 下 可 以 使 用 DbUnit 等 工具 ， 虽 然 这 些 工 具有 些 旧 了 ， 但 还 是 多 少 能 
够 节省 一 些 时 间 。 
@) 当然 配置 可 以 修改。 
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且 还 提供 了 名 为 Fixture 的 数据 加 载 机 制 。 借 助 该 机 制 ， 执 行 测试 时 就 
可 以 用 和 正式 环境 相同 的 步骤 ,在 内 存 上 高 速 地 构建 数据 库 和 表 ， 加 载 
数据 ， 在 此 基础 上 ， 编 写 的 测试 用 例 也 能 够 以 和 正式 环境 相同 的 方式 来 
访问 数据 。 因 为 是 内 存 数据 库 ， 所 以 能 够 在 测试 结束 后 轻易 地 销毁 。 测 
试 也 因此 具备 了 很 高 的 独立 性 。 写 过 测试 代码 的 各 位 一 定 知 道 ， 和 数据 
库 紧 密 耦合 的 话 ， 每 次 测试 后 数据 库 状 态 都 会 发 生变 化 ， 因 此 测试 非常 
难 写 。 而 内 存 数 据 库 将 很 大 程度 地 改善 这 个 问题 。 
































@…… 数据 库 变更 管理 和 配置 文件 管理 的 测试 


如 第 3 章 中 所 提 到 的 那样 ， 在 利用 数据 库 迁移 机 制 进行 数据 库 的 变 
更 管理 的 情况 下 ，SQL 的 正确 与 否 可 以 通过 表 的 生成 是 否 正 确 来 判断 ， 
但 应 用 程序 的 动作 是 否 正 确 还 不 得 而 知 。 

数据 库 迁 移 自身 的 测试 也 可 以 简单 地 写 一 下 。 数 据 库 构 筑 完成 后 ， 
写 一 下 简单 的 冒 烟 测试 ”, 只 要 能 够 确认 应 用 程序 的 基本 部 分 运行 正常 就 
可 以 了 。 

环境 构建 部 分 的 测试 同样 也 是 写 一 下 比较 好 。 中 间 件 启动 后 ， 确 认 
一 下 是 否 有 响应 ， 即 使 是 这 样 简单 的 测试 ， 也 是 非常 有 效 的 。 关 于 使 用 
Chef 或 serverspec 的 环境 构建 自动 化 以 及 相关 的 测试 详情 ， 我 们 将 在 第 
6 章 讲述 。 

数据 库 的 变更 管理 也 好 ， 环 境 配 置 管理 也 好 ， 为 测试 这 些 项 目 ， 严 
密 地 说 需要 在 这 些 项 目的 基础 上 来 确认 应 用 程序 的 所 有 动作 。 从 这 个 意 
义 上 来 说 ， 如 果 要 对 这 方面 进行 严密 的 测试 的 话 ， 通 过 用 户 验收 测试 来 
确认 是 比较 正确 的 做 法 。 当 然 也 要 根据 工程 的 状况 、 预 算 以 及 期 限 适 度 
地 编写 测试 。 














































































































@…… UI 相关 的 测试 


UI 相关 的 测试 是 比较 困难 的 部 分 。 因 此 要 尽 可 能 地 将 业务 逻辑 内 到 
在 MVC 模式 中 的 M (模型 ) 中 ,设计 为 不 必 涉 及 UI 就 能 网 罗 几 乎 所 








QD 简单 的 动作 确认 测试 。 为 了 确认 是 否 能 够 实施 正式 的 测试 而 进行 的 准备 性 质 的 测 
试 。 原 本 是 电机 行业 的 术语 ， 指 将 冰箱 、 电 视 机 等 接 通 电源 看 看 有 没有 冒 烟 。 
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有 的 测试 用 例 。 应 该 尽量 避免 编写 依赖 于 UI 的 测试 。 

最 近 使 用 充分 挖掘 了 Ajax 特性 的 Rich UI 的 Web 应 用 程序 也 开始 
多 了 起 来 。 随 之 而 来 的 是 ，JavaScript 的 MVC 框架 也 开始 大 量 出 现 。 如 
果 在 客户 端 较 多 地 使 用 了 JavaScript 的 话 ， 应 该 尽量 将 业务 逻辑 内 聚 在 
M 之 中 ， 以 便 可 以 通过 UI 以 外 的 部 分 进行 测试 。 

不 得 不 针对 UI 编写 测试 的 情况 下 ， 可 以 利用 Selenium 这 样 的 工具 
来 实现 用 户 验 收 测试 的 自动 化 。 使 用 Selenium 的 用 户 验收 测试 自动 化 的 
相关 内 容 将 在 第 7 章 详细 讲解 。 






























































@…… 束 手 的 测试 要 权衡 工 数 


编写 和 外 部 交互 相关 的 测试 或 数据 库 变 更 管理 、UI 相关 的 测试 等 相 
当 环 手 的 测试 自然 会 耗费 相当 多 的 工 数 。 如 果 只 考虑 质量 的 话 ， 这 些 测 
试 的 确 是 完整 地 写 一 下 比较 好 ， 但 实际 上 编写 测试 可 用 的 时 间 并 不 是 无 
限 的 。 
测试 的 自动 化 是 越 做 越 耗费 时 间 和 精力 。 将 编写 测试 所 获得 的 质量 
提升 以 及 能 够 在 未 来 消减 的 工 数 ， 与 编写 测试 实际 耗费 的 工 数 进行 权 
衡 ， 注 意 保持 两 者 的 平衡 。 

如 果 过 度 执着 于 测试 自动 化 的 工作 ， 其 本 身 就 像 填 字 游 戏 一 样 ， 虽 
然 有 趣 ， 但 不 知 不 觉 之 中 就 可 能 做 过 了 头 ， 投 入 和 回报 不 相符 了 。 

请 大 家 根据 自身 所 处 的 状况 ， 以 及 项 目 所 追求 的 价值 ， 在 最 合适 的 
限度 内 来 实现 测试 的 自动 化 。 
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5.4 执行 基于 Jenkins 的 CI 








已 经 集 齐 了 所 需要 的 版 本 管理 系统 、 自 动 build 以 及 测试 代码 之 后 
接 下 来 就 让 我 们 实际 使 用 Jenkins 来 实施 CI 吧 


Lo 











5.4.1 Jenkins 的 安装 


Jenkins 的 安装 非常 简单 。 从 主页 “下载 WAR 文件 并 执行 以 下 命令 
即 可 。 








$ java -jar jenkins.war 


启动 Jenkins 后 访问 http://localhost:8080， 若 显示 如 图 5.7 
这 样 的 画面 ， 即 说 明 安 装 成 功 了 。 





图 5.7 ”Jenkins 安装 完成 画面 





过 Jenkins 
Jenkins 入 洗 自 动 届 新 
人 新建 蕙 还 加 说 明 
多 A 欢迎 使 用 Jenkins! 

有 任务 历史 

区 5 | fs 人 建 一 人 亲人 条 


条 Credentials 


构建 队列 
队列 中 没有 构建 任务 


也 过 动 我 们 二 地 化 尖 前 页 





生成 页 画 : 2014-11-23 18:09:44 ”RESTAPI Jenkins ver 1.590 
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e@…… 使 用 本 地 安装 包 进 行 安装 


在 刚才 的 例子 中 ,为 了 体现 启动 Jenkins 有 多么 简单 ， 选 择 了 直接 
使 用 WAR 包 启 动 。 而 在 实际 的 开发 现场 ， 则 是 将 Jenkins 作为 OS 的 服 
务 (UNIX/Linux 环境 的 守护 程序 ) 启动 比较 好 。Jenkins 为 各 个 OS 提 
供 了 安装 包 。 例 如 ， 使 用 Windows 平 台 的 安装 包 进 行 安装 就 能 作为 
Windows 的 服务 启动 ， 使 用 CentOS 的 安装 包 就 能 作为 Linux 的 驻守 程 
序 启动 。Jenkins 的 主页 上 记载 有 各 个 OS 的 本 地 安装 包 的 安装 方法 ， 可 
以 参考 。 

这 里 以 Red Hat Enterprise Linux 为 例 进行 讲解 。 新 建 Jenkins 用 的 目 
录 并 执行 yum 命 令 即 可 。 启 动 脚本 也 会 一 并 安装 。 


$ wget -0 /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/ 
jenkins.repo 


























$ rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key 
$ yum install jenkins 


执行 如 下 命令 ， 即 可 将 Jenkins 作为 OS 的 守护 程序 启动 。 
§ /etc/rc.d/init.d/jenkins start 
和 使 用 WAR 启动 时 一 样 ， 启 动 后 请 试 着 访问 http://localhost: 
8080， 若 显示 如 图 5.7 这 样 的 画面 ， 即 说 明 安 装 成 功 。 
顺便 提 一 下 , Jenkins 还 能 在 Tomcat 等 Servlet 容器 上 启动 。 这 时 会 
监听 ajp 的 8009 端口 ， 所 以 用 proxy _ajp 等 作为 代理 上 传 至 服务 器 即 可 。 



































5.4.2 Jenkins 能 干 些 什么 























Jenkins 是 一 款 为 实施 CI 提供 支持 的 工具 ,通过 和 各 类 插件 组 合 使 
用 ， 可 以 实现 非常 丰富 的 功能 。 详 细 内 容 可 以 参考 Jenkins 相关 的 书籍 ”。 
这 里 对 Jenkins 所 支持 的 最 基本 的 CI 进行 说 明 。 先 前 列举 了 CI 所 
必需 的 版 本 管理 系统 、build 工具 、 测 试 代码 ， 将 这 些 组 合 起 来 构建 如 下 
这 样 的 机 币 
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o 





中 http:/tomcat.apache.org/ 
©® John Ferguson Smart 著 ，Jenkins: The Definitive Guide,O’ Reilly Media, Inc, USA, 
2011 
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@ 下 载 ( checkout ) 代码 
@ 自动 build 并 执行 测试 
@ 统计 结果 并 制作 报表 

@ 通知 





证 我 们 试 着 来 建立 一 种 机 制 ， 实 现 当 代码 有 更 新 时 能 够 立即 并 且 持 
续 地 执行 上 述 一 系列 处 理 。 











5.4.3 “新建 任务 





Jenkins 以 任务 (Job ) 为 单位 来 管理 一 系列 的 处 理 流 程 。 可 以 姑且 
理解 为 1 个 应 用 对 应 1 个 任务 ， 或 者 1 个 目录 对 应 1 个 任务 “。 
首先 在 Jenkins 上 新 建 任 务 。 点 击 菜单 上 的 “创建 一 个 新 任务 ”， 会 
出 现 “ 构 建 一 个 自由 风格 的 软件 项 目 ” “构建 一 个 Maven2/3 项 目 ”“ 构 
建 一 个 多 配置 项 目 ” “监控 一 个 外 部 的 任务 ”“ 复 制 已 有 的 Item”5 个 选 
项 ， 这 些 选项 各 自 的 内 容 在 Jenkins 的 主页 上 都 有 说 明 ， 请 自行 参考 。 

如 果 使 用 Maven bulid 工程 的 话 ， 可 以 选择 “构建 一 个 Maven2/3 项 
目 ”。Jenkins 支持 向 Maven 目录 公开 (publish ) 所 生成 的 文件 之 前 的 流 
程 。 而 如 果 是 Ruby、Node.js 等 Java 之 外 的 项 目 ， 或 者 是 使 用 Maven 以 
外 的 Java 项 目 ， 请 选择 “构建 一 个 自由 风格 的 软件 项 目 ”。 






























































5.4.4 下 载 代 码 





下 面 进行 从 版 本 管理 系统 下 载 ( checkout ) 代码 的 配置 。 虽 然 这 里 
写 的 是 “代码 ”， 但 是 应 该 进行 版 本 管理 的 并 不 仅 限于 代码 ， 还 包括 数 
据 库 模式 的 定义 和 配置 文件 等 应 用 程序 启动 所 需 的 所 有 资源 。 用 Jenkins 
将 这 些 资 源 下 载 到 干净 的 环境 。 

上 述 内 容 在 代码 管理 这 一 项 目 中 进行 配置 。Jenkins 默认 可 选 的 代码 
管理 系统 为 CVS 和 Subversion， 使 用 其 他 的 版 本 管理 系统 需要 安装 插件 。 

这 里 以 使 用 Git 作为 前 提 进 行 讲解 。 点 击 菜单 中 的 “系统 管理 "， 打 


Q 实际 上 1 个 任务 也 可 以 操作 多 个 目录 ， 通 过 配置 可 以 实现 各 种 不 同 的 运用 。 
























































图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 














174 | 第 5 章 CI (持续 集成 ) 

















开 “ 管 理 搬 件 "， 在 “可 选 搬 件 ”标签 下 查找 名 为 “Git Plugin” 的 项 目 


(图 5.8 )。 








图 5.8 Git Plugin 


者 Jenkins Ee 
Jenkins 插件 管理 
会 返回 过 沽 :区 Git Plugin 
关 系统 管理 ames ea 
安 版 
装 | 名 称 本 
Git Parameter Plugn 
回 E 2 En Pe Ee 加 032 
This plugin allows you to choose between Git tags or sha1 of your SCM repository so Git Plugin installed is required 
回 Git os Altemative Plugin 11 


alternalti 





加 10.9 
_ Tracking Git Plugin 
加 10 
Lets one project track the Git revisions that are built for another project 
Git Plugin 
国 This ph e is required (1.7.9 minimum, 1.8.x recommended). Plugin is only 23 





s plug 
tested on official 








ET Er 

点 击 “ 下 载 待 重启 后 安装 ”按钮 ， 重 启 Jenkins， 完 成 安装 。 再 次 打 

开 任 务 的 配置 页 面 ， 确 认 一 下 代码 管理 的 地 方 ， 可 以 看 到 增加 了 名 为 
Git 的 选项 。 按 照 图 5.9 进行 配置 。 


图 5.9 ”Git 的 配置 





[hdll 
































源码 管理 
D None 
© cvs 
© cvs Projectset 
@ Git 
Repositories 
人 Repository URL | github.com/Shanon/DeeElle.git © 
Credentials 
-none- 4 
= Add © 
高 级 … 
Add Repository Delete Repository 
Branches to build Branch Specifier blank for ‘any) (eee © 
Add Branch Delete Branch 
源码 库 浏览 
源码 库 浏览 器 githubweb 日 © 
URL https-Wgithub com/Shanon/DeeElle/ 
本 
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图 5.9 中 ， 在 “Repository URL” 中 填写 Git 的 URL， 在 “Branches 
to build” 中 填写 build 对 象 的 分 支 名 称 。 然 后 在 “源码 浏览 器 ”处 填写 
阅览 Git 时 使 用 的 工具 ， 这 里 选择 了 githupweb， 其 他 还 有 Gitlab 和 
Gitrious 等 选项 。 























5.4.5 自动 执行 build 和 测试 





下 面 对 build 进行 配置 。 分 别 对 “构建 触发 器 ”和 “构建 (build 也 
进行 设置 。 
在 “构建 触发 需 ” 中 配置 执行 build 的 触发 髓 。 














@…… 定 期 执行 


比如 1 天 执行 1 次 、 每 隔 4 小 时 执行 1 次 等 ， 设 置 为 定期 自动 执行 
build 的 方式 。 可 以 用 近似 于 cron 的 写法 来 设置 执行 的 频率 。 

定期 执行 是 从 还 没有 CI 这 个 词汇 时 就 有 的 手法 。 例 如 Joel on 
Sofiware" 中 写 到 了 Microsoft 从 1990 年 代 开始 1 天 进行 1 次 build ( daily 
build )。 还 有 描写 1990 年 代 初 Windows NT 的 开发 的 《 观 止 一 一 微软 创 
建 NT 和 未 来 的 夺 命 狂奔 兴 ， 其 中 也 提 到 了 daily build。 

daily build 严格 来 说 并 不 是 CI， 但 配置 简单 ， 实 施 起 来 也 算是 不 错 
的 方式 。1 天 之 内 提交 的 量 并 不 是 太 多 的 话 ， 进 行 daily build 也 不 会 有 
什么 问题 。 也 有 一 些 案例 是 因为 build 或 测试 的 执行 时 间 过 长 ， 导 致 无 
法 及 时 build 而 不 得 不 采用 daily build 的 方法 。 定 期 执行 作为 CI 来 说 虽 
然 有 所 欠缺 ， 但 比 起 什么 都 不 做 来 说 还 是 要 好 很 多 的 。 





湾 






























































e…… 轮 询 版 本 管理 系统 


即 配置 为 以 轮 询 (polling ) 的 方式 监视 版 本 管理 系统 ， 有 新 的 提交 
(Push ) 时 就 执行 build 的 方式 。 能 够 用 类 似 于 cron 的 写法 来 指定 轮 询 的 




















四。 Avram Joel Spolsky, Joel on Software, APress，2004 年 
@ 《 观 止 微软 创建 NT 和 未 来 的 夺 命 狂奔 》G. Pascal Zachary 著 ， 张 银 奎 译 ， 机 
械 工 业 出 版 社 ，2009 
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频率 。 由 于 在 每 次 提交 时 都 会 进行 build 及 测试 ， 因 此 能 够 更 早 地 发 现 
问题 ， 有 助 于 质量 的 提高 。 

因为 采取 的 是 轮 询 的 方式 ， 所 以 无 论 是 否 有 提交 都 会 向 版 本 管理 系 
统 发 送 请 求 。 虽 然 这 会 给 系统 造成 不 必要 的 负担 ， 但 只 要 没有 太 大 的 问 
题 ， 采 用 轮 询 的 方式 还 是 能 够 比较 方便 地 实施 CI 的 。 

build 执行 的 频率 增加 后 ，build 的 速度 就 变 得 很 重要 。 过 于 缓慢 的 
话 ， 提 交集 中 时 ，build 会 积累 在 任务 队列 中 ， 变 得 难以 及 时 地 察觉 问 
题 。 为 了 避免 这 样 的 情况 ， 就 需要 在 build 或 测试 代码 上 下 功夫 ， 提 高 
CI 服务 器 的 处 理 速 度 ， 增 加 服务 器 台数 实行 并 行 build 等 。 

尽 可 能 地 避免 定期 执行 ， 以 每 次 提交 时 进行 build 这 样 的 循环 来 实 
施 CI 是 很 重要 的 ， 因 为 这 样 版 本 管理 系统 的 提交 记录 和 CI 服务 器 的 
build 结果 就 能 关联 起 来 ， 工 程 的 可 追溯 性 能 够 得 到 提高 。 
























































-一 专栏 ”从 版 本 管理 系统 进行 Push 
从 Jenkins 的 配置 来 说 ,“ 轮 询 版 本 管理 系统 ”是 最 适合 于 CI 
的 ， 但 最 好 能 够 由 版 本 管理 系统 通过 Push 来 请 求 Jenkins 执行 
build。Git 和 Subversion 都 能 够 配置 Push， 这 里 介绍 下 使 用 Git 的 
方法 。 
Git 提供 了 在 发 生 提 交 或 收 到 Push 等 事件 时 执行 特定 脚本 这 样 
的 钩子 ( hook ) 的 机 制 。 在 各 个 代码 库 下 的 .git/hooks/ 目录 下 有 示 
例文 件 ， 编 写 自己 的 脚本 时 可 以 进行 参考 。 详 细 内 容 请 见 Po Git"。 
Subversion 也 有 钩子 的 机 制 ， 可 以 实现 相同 的 功能 。 
例如 ， 在 代码 被 Push 到 Git 代码 库 时 ， 若 要 执行 Jenkins 的 任 
务 ， 可 以 建立 .git/hooks/post-receive 文件 ， 并 按照 下 面 的 内 容 进行 
编辑 。 上 述 处 理 是 以 安装 Jenkins 的 Git Plugin 为 前 提 的 。 


#!/bin/sh 
curl http://{Jenkins 服务 器 的 域名 或 IP 地 址 等 }/jenkins/ 
git/notifyCommit?url={Git 代码 库 的 URL} &branches={ 分 支 名 ( 可 以 设置 
2 


curl 部 分 也 可 以 是 wget 等 命令 ， 只 要 配置 后 能 够 向 Jenkins 发 

































































































































































































































































D http://git.oschina.net/progit/ 
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送 上 述 这 样 的 GET 请 求 即 可 。 
通过 上 述 配 置 ， 在 Git 代码 库 收 到 Push 时 就 会 向 Jenkins 发 送 
上 述 GET 请 求 。 收 到 请 求 的 Jenkins 会 执行 包含 对 应 代码 库 的 所 有 
任务 。 关 于 这 个 功能 的 详细 内 容 请 参考 Git Plugin 的 帮助 “。 

如 果 使 用 的 是 GitHub 的 话 ， 可 以 利用 GitHub 的 Service Hooks 
设置 。 打 开 代 码 库 Settings 下 的 Service Hooks 就 能 看 到 ，GitHub 
能 够 和 全 世界 的 各 类 服务 进行 交互 ( 图 5.a )。 


























































































































图 5.a Service Hooks 














© . Thisrepository ~ Search orypeacommand  @ 次 Explore Gist Blog Help 酮 ieikeq4s 虹 XB 
长 Shanon / DeeElle 
主 
Options AVAILABLE SERVICE HOOKS 
ee Webiool UALe (6) C service hooks share your commits with other apps 
ActiveCollab 
Service Hooks Acunote 
Deploy Keys AglleBench 
AgileZen 
AmazonSNS 
Apiary 
Apolo 
AppHarbor 
Asana 
Backlog 
Bamboo (Cee) 
Basecaml pClassic 
Basecar mp Plus 134 other apps! 





从 中 选择 Jenkins， 并 配置 好 Jenkins 的 URL， 就 能 同样 在 
GitHub 收 到 Push 时 向 Jenkins 发 送 执行 任务 的 请 求 。 但 是 需要 注 
意 的 是 要 将 Jenkins 搭建 在 GitHub 可 见 之 处 。 通 常 Jenkins 多 被 拱 
建 在 公司 内 部 的 局 域 网 ( LAN ) 中 ， 所 以 需要 在 网 络 的 配置 上 下 一 
些 功夫 。 顺 便 提 一 下 ，GitHub 发 送 请 求 的 服务 器 IP 地 址 是 公开 的 ， 
只 要 对 Jenkins 加 上 IP 限制 ， 就 能 够 消除 安全 方面 的 隐患 。 

这 样 的 方法 能 够 消除 延迟 ， 实 现在 每 次 提交 后 立即 实施 bui 
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@…… build 的 记述 








下 面 来 讲 一 下 build 以 及 测试 的 人 处理。 可 以 在 “增加 构建 步骤 ”中 
选择 Ant、Maven、shell 脚本 、Windows 批 处 理 文件 中 的 任意 一 项 。 
Java 的 项 目 可 以 选择 Ant 或 Maven。 

















OD https://wikijenkins-ci.org/display/JENKINS/Git+plugin 
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如 果 是 Java 以 外 的 语言 的 话 ， 可 以 用 shell 脚本 来 记述 build 的 处 
理 。 使 用 Make、Rake 或 SBT 等 build 工 具 的 话 也 没有 问题 。 虽 然 在 
Jenkins 的 配置 页 面 上 能 够 直接 编辑 shell 脚本 ， 但 还 是 建议 将 build 脚本 
记录 在 文件 中 并 提交 到 版 本 管理 系统 ， 在 Jenkins 中 只 做 简单 的 调用 。 这 
样 即便 没有 Jenkins， 也 能 够 以 完全 相同 的 方法 来 执行 build， 非 常 方 便 。 

另外 ， 如 果 不 使 用 build 工具 ， 而 是 利用 shell 脚本 来 描述 build 的 
话 , 请 设置 相 适 应 的 退出 值 ( exit code ) "。Jenkins 根据 该 值 来 判断 任务 
的 执行 是 失败 还 是 成 功 。 






















































































5.4.6 ”统计 结果 并 生成 报表 


可 以 在 “构建 后 操作 ”中 选择 结果 的 通知 方式 。 
可 选 的 项 目 各 种 各 样 ， 这 里 为 了 便于 统计 测试 结果 ， 请 选择 
“Publish JUnit test result report”。 随 后 就 会 出 现 设 置 测试 结果 XML 文件 
的 路 径 的 输入 框 ， 输 入 测试 结果 XML 文件 的 路 径 即 可 。 这 样 配置 后 再 
进行 build， 就 能 如 图 5.10 这 样 在 浏览 器 上 确认 结 
5.10 ”测试 结果 
测试 结果 


失败 5 个 (+5), 跳 过 8 个 ( +0) 
mi 


























253 个 测试 ( 上 0 ) 
所 用 时 间 34 分 
米 深 加 说 明 


所 有 失败 的 测试 


测试 所 用 时 间 时 期 
1.9 黎 

2.2 秒 

0.67 秒 和 
1 

1 








1.1 秒 
1.8 秒 





co.shanon.ss.api.services.VisitorTest,testUpsert Put 





所 有 测试 











包 测试 所 用 时 间 ”失败 ”|( 差分 ) 跳 过 (差分 ) 合计 ”| 差分) 
.co.shanon.s: 34 分 5| +45 8 251 
6 ms 0 0 2 




















从 图 5.10 中 可 以 看 出 ，253 个 测试 中 有 5 个 测试 失败 了 。 测 试 所 消 
耗 的 时 间 也 能 从 图 上 看 出 。 从 “时 期 ”这 一 列 可 以 知道 这 是 从 在 此 之 前 
的 第 几 次 build 开始 出 现 失败 的 ， 图 5.10 中 的 5 个 测试 都 是 在 这 次 build 








四” 成功 的 话 返回 “exit 0"， 失 败 的 话 返回 “exit 9”。 
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中 才 失 败 的 。 其 他 还 有 一 些 针 对 包 的 测试 ， 可 以 看 出 和 上 一 次 build 相 
比较 ， 失 败 的 个 数 有 所 增加 。 


一 专栏 ”以 JUnitXML 的 形式 输出 报表 比较 高 效 
通过 使 用 播 件 ， 还 可 以 对 JUnitXML 之 外 的 测试 结果 进行 统计 。 
但 考虑 到 通用 性 和 报表 的 直观 性 ， 以 JUnitXML 形式 输出 的 报表 是 最 
效 的 。 如 果 使 用 的 测试 框架 是 JUnit 的 话 自然 没有 问题 。 如 果 使 用 
的 是 其 他 测试 框架 ， 因 为 报表 生成 部 分 的 实现 大 多 能 以 插件 的 形式 
进行 替换 ， 所 以 这 里 推荐 修改 为 以 JUnitXML 的 形式 来 生成 报表 。 
例如 Scala 的 Specs2 就 能 够 通过 修改 配置 来 改变 生成 报表 的 
式 。JavaScript 的 Jasmine 也 有 志愿 者 制作 的 名 为 JUnitXmlReporter 
9 输出 JUnitXML 的 对 象 ”。 其 他 的 语言 也 基本 都 能 够 输出 JUnitXML， 
丸 此 建议 先 调查 清楚 再 着 手 应 对 。 
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5.4.7 ”统计 覆盖 率 























至 此 ， 我 们 实现 了 到 统计 持续 build 及 测试 结果 为 止 的 处 理 流程 。 
通过 自动 执行 测试 ， 对 于 测试 覆盖 的 部 分 就 能 够 确认 测试 是 否 成 功 ， 但 
测试 没有 获 盖 的 部 分 就 没有 任何 信息 。 这 样 的 情况 下 ， 让 我 们 来 统计 一 
下 代码 覆盖 率 ( code coverage )。 代 人 码 履 盖 率 是 表示 测试 对 象 的 应 用 程 
序 代 人 码 在 测试 中 被 执行 了 多 少 的 指标 。 统 计 和 覆盖 率 能 够 看 出 代码 被 测 
试 的 程度 ,或 者 反 过 来 说 ， 能 够 使 还 需要 增加 多 少 测试 这 样 的 信息 可 
视 化 。 

但 需要 注意 的 是 ， 代 人 码 覆 六 率 只 是 反映 了 测试 对 象 的 应 用 程序 代码 
是 否 被 执行 ， 并 不 能 反映 出 用 作 测 试 的 测试 代码 是 否 受 当 ， 因 此 并 不 可 
以 盲目 相信 。 但 在 认识 到 需要 通过 代码 审阅 ( source review ) 等 方式 来 
确保 测试 代码 的 内 容 的 正确 性 之 后 ， 代 码 覆 盖 率 作为 质量 指标 之 一 会 变 
得 很 重要 ， 所 以 请 一 定 要 试 着 用 一 下 。 



























































中 https:/Wgithub.conylarrymyers/jasmine-reporters 
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e…… 覆盖 率 统计 工具 


统计 覆盖 率 需 要 安装 专门 的 工具 。 具 有 代表 性 的 覆盖 率 统计 工具 有 
下 面 这 些 。 








@ Cobertura! 
® Jacoco2 

@ Scct” 

® SimpleCov 


@ Rcov” 


这 些 工 具 是 以 Ant、Maven 、SBT 、Rake 等 build 工具 的 插件 的 形式 
提供 的 。 可 以 根据 开发 环境 选择 合适 的 工具 。 这 次 以 作为 Maven 的 插件 
提供 的 Cobertura 为 例 进 行 讲 解 “。 





























全 Maven Cobertura 插件 的 安装 





在 Maven 中 使 用 Cobertura， 只 需要 在 pom.xml 中 定义 如 下 依赖 关 
系 即 可 。 


<dependencies> 





<dependency> 
<groupId>org.codehaus .mojo</groupId> 
<artifactIid>cobertura-maven-plugin</artifactId> 
<version>2.5.2</version> 
</dependency> 
</dependencies> 


依赖 关系 定义 完 后 ， 执 行 下 列 命 令 。 


mvn cobertura:cobertura 


Ur 





http://cobertura.github.io/cobertura/ 

http://www.eclemma.org/jacoco/ 

https:/github.comy/sqality/scct 

https://www.ruby-toolbox.com/projects/simplecov 

https://github.com/relevance/rcov 

Cobertura 已 经 于 2011 停止 了 开发 ， 所 以 今后 改 用 Jacoco 比较 好 。 因 为 习惯 了 用 
Cobertura 编写 报表 的 方式 ， 笔 者 个 人 比较 喜欢 使 用 Cobertura， 而 且 现 在 还 在 使 
用 。Java 之 外 的 语言 的 履 盖 率 统计 工具 也 大 都 支持 Cobertura 形式 的 XML。 


OG@OQOO0O 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


5.4 ”执行 基于 Jenkins 的 Cl | 181 




















这 样 就 会 执行 测试 ， 并 在 测试 之 后 对 覆盖 率 进 行 统 计 。 结 果 文 件 以 





html 的 形式 生成 在 target/site/cobertura/ 目 录 下 。 可 以 在 浏览 
器 上 打开 index.html 来 确认 报表 (图 5.11 )。 


图 5.11 ”覆盖 率 的 报表 














Packages Coverage Report - All Packages 
al | 
Li | ; 
pr Package #Classes Line Coverage Branch Coverage Complexity 
|| All Packages 1 0 N/A N/A 1 
com.gmail.ikeike443 1 0oo N/A N/A 1 




















|| Report generated by Cobertura 1.9.4.1 on 13/05/25 22:27. 














All Packages 


Classes 
App (0%) 











> 




















图 5.11 中 因为 还 没有 编写 测试 ， 所 以 覆盖 率 为 0%。 添 加 测试 后 就 








过 报表 确认 覆盖 率 上 升 。 作 为 供 人 阅览 的 报表 来 说 ， 这 样 的 HTML 


能 通 


形式 确实 看 起 来 比较 方便 ， 但 就 利用 Jenkins 来 实现 CI 来 看 ， 还 是 以 计 
算 机 易于 理解 的 XML 形式 输出 文件 比较 方便 。Cobertura 的 报表 的 默认 
形式 是 HTML， 可 以 通过 修改 配置 同时 生成 XML 形式 的 报表 。 


如 下 这 样 编辑 pom.xml。 





<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// 
www.w3 .org/2001/XMLSchema-instance" 


xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven. 


apache.org/xsd/maven-4.0.0.xsd"> 


<properties> 


<project .build.sourceEncoding>UTF-8</project .build.sourceEncoding> 


</properties> 
<build> 


<plugins> 
<plugin> 
<groupId>org.codehaus .mojo</groupId> 
<artifactId>cobertura-maven-plugin</artifactId> 
<configuration> 
<formats> 
<format >xml</format> 
<format>html</format> 
</formats> 
</configuration> 
</plugin> 
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</plugins> 
eal 
<dependencies> 
略 
</dependencies> 
</project> 


在 这 样 的 状态 下 再 次 执行 mvn cobertura : cobertura， 就 会 
发 现 除了 之 前 的 html 文件 之 外 ， 还 生成 了 名 为 coverage.xml 的 文件 。 
这 样 覆 盖 率 的 统计 就 完成 了 。 接 着 让 我 们 对 Jenkins 进行 配置 。 





一 专栏 Java 程序 库 的 查找 方法 
笔者 参与 过 数 个 开发 现场 ， 其 间 所 体会 到 的 事情 之 一 就 是 使 
用 Java 的 开发 现场 中 程序 库 的 查找 方式 以 及 安装 方法 存在 不 恰当 
的 地 方 。 
在 Web 上 检索 相关 信息 ， 下 载 可 能 符合 条 件 的 jar 文件， 并 将 
其 加 入 class path 使 用 ， 这 样 的 事例 意外 的 多 。 如 此 一 来 程序 库 的 可 
信 度 就 有 问题 了 。 

Perl 和 Ruby 这 样 的 脚本 语言 ， 各 个 社区 之 间 彻 底 地 应 用 了 包 
( package ) 管理 。 但 Java 不 全 是 这 样 。 脚 本 语言 从 早期 就 采取 了 包 
管理 的 机 制 ， 和 OSS 亲 和 性 比较 高 。 

Java 也 有 包 管 理 机 制 ， 如 Maven 人 仓库。 访问 http:/search. 
maven.org 就 可 以 看 到 很 多 Java 系 语 言 ( 也 包括 Scala、Groovy、 
JRuby 等 ) 的 OSS 程序 库 。 
例如 ， 搜 索 Cobertura， 可 以 找到 几 个 符合 条 件 的 程序 库 。 这 里 
试 着 使 用 一 下 Cobertura 的 Maven 插件 ( 图 5.b )。 

从 图 5.b 可 以 看 出 如 何在 Maven 的 pom.xml 中 添加 依赖 关系 来 
安装 Cobertura。 图 中 还 记载 了 使 用 lvy 和 SBT 以 及 其 他 build 工 
时 的 写法 ， 请 务必 参考 。 
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图 5.b ”Cobertura 的 Maven 插件 





于 The Central Repository ee 
[eoberura 


New: App Scan Advanced Search | APLGulde | Help 


Artifact Details For org.codehaus.mojo : cobertura-maven-plugin : 2.5.2 


Click on a link above to browse the repository. 


pe ose tenn rom 


Groupld: org.codehaus.mojo 





Feedback 


Artfactid: cobertura-maven-plugin 


Version。 2.52 


Dependency Information 


Apache Maven 








人 站 vy 
Groovy Grape 
Grails 

Scala SET 


























© Jenkins 插件 的 配置 


能 够 在 Maven 中 执行 Cobertura 后 ， 接 着 对 Jenkins 进行 配置 。 
Jenkins 中 提供 了 Cobertura 的 插件 ， 和 安装 Git 的 插件 一 样 ， 请 从 插件 
管理 进行 安装 。 

安装 完成 后 ， 在 任务 配置 的 构建 后 操作 中 会 增加 选项 “Publish 
Cobertura Coverage Report”， 选 中 该 项 。 在 出 现 的 配置 栏 (图 5.12 ) 中 
输入 **/target/site/cobertura/coverage.xml， 其 他 的 配置 
保留 默认 值 即 可 。 
5.12 ”Cobertura 覆盖 率 报表 统计 


构建 后 操作 





























Publish Cobertura Coverage Report 
Cobertura xml report pattern 


Thi bp a tle reams pattem tet cn bin ned to locate Whe embed srl mpi Seg (ior imiplhs hth Me Le Sareetinenhar iota rt: Ths peth ls raat tothe 
oder TREE alative to meworspace Wot. Note hat the modue Is SCM sfectic and may not be 
pple root, 

Cobertura must be configured to generate XML reports for this plugin to function. 


Consider only stable builds = 


Include only stable bullds Le. excilude unstable and faled ones, 
Fail builds if no reports 


fall bulds if No coverage reports are founc. 











这 样 Cobertura 的 配置 就 完成 了 。Jenkins 会 将 覆盖 率 的 报表 以 美观 、 
易 懂 的 形式 呈现 出 来 (图 5.13 )。 
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5.13 ”Jenkins 的 覆盖 率 报表 





代码 . 覆盖 率 


Cobertura 覆盖 率 报表 
时 间 顺 序 
100 


























] 要 | En I 本 | 厂 5 | 吾 
77% Be | 40% | 82% [S173 | 56% [ 550718| cow | 100% 2 
每 个 包 的 覆盖 率 统计 结果 




















美 条 件 文件 行 方法 | 
gow| 2425 上 2% [| 100% 2 | 44% | 343 76%[ 109/144 国 到 
3% | cy Ca | se% | 70% 5 | 5% EAI 


Jenkins 下 能 够 看 到 每 种 度量 方式 的 覆盖 率 变化 的 图 表 ， 以 及 更 进 一 
步 的 每 个 class 文件 的 覆盖 率 。 开 始 统 计 和 覆盖 率 后 ， 开 发 人 员 编 写 测试 
代码 的 积极 性 也 会 有 所 提高 。 看 着 每 次 添加 测试 覆盖 率 都 会 有 所 提升 ， 
这 是 一 件 很 有 成 就 感 的 事情 。 在 提高 团队 开发 的 质量 的 过 程 中 ,维持 开 
发 人 员 编写 测试 代码 的 积极 性 是 相当 重要 的 要 素 ， 从 这 一 意义 上 来 说 对 

盖 率 的 统计 也 是 相当 重要 的 。 




































































5.4.8 ”静态 分 析 


在 自动 化 测试 和 统计 代码 覆盖 率 的 基础 上 ， 若 能 对 代码 实施 静态 分 
析 ， 就 可 以 进一步 提高 团队 开发 的 质量 。 因 此 应 通过 Jenkins 持续 地 检 
查 代 码 是 否 符合 编码 规则 、 是 否 容 易 产生 bug 等 。 

能 够 在 Jenkins 中 使 用 的 静态 分 析 工 具有 以 下 这 些 。 





























@ Checkstyle” 
e@PMD2? 
® Findbugs® 





OD http://checkstyle.sourceforge.net/ 
©® http:/pmd.sourceforge.net/ 
@) http://findbugs.sourceforge.net/ 
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各 个 工具 都 有 自己 的 特点 。Checkstyle 擅长 编码 规则 的 检查 等 ; 
PMD 的 可 定制 化 的 程度 高 ， 对 编码 规则 以 及 潜在 的 bug 都 能 够 检查 ; 
Findbugs 则 以 善于 检查 潜在 的 bug 为 特点 。 各 个 工具 都 支持 规则 的 定制 
和 扩展 。 请 根据 项 目的 具体 情况 选择 合适 的 工具 。 

使 用 Maven 作为 build 工具 的 话 ， 静 态 分 析 工 具 和 JUnit、Cobertura 
一 样 ， 安 装 Maven 的 插件 即 可 使 用 。 当 然 在 Ant 等 上 面 也 可 以 使 用 。 
Jenkins 的 话 同样 只 要 安装 插件 就 能 使 用 。 

通过 CI 实施 静态 分 析 的 优点 有 很 多 ， 其 中 最 显著 的 是 可 以 减轻 代 
人 码 review 时 的 负担 这 一 点 。 代 码 review 虽说 是 为 了 提高 质量 而 需要 实 
施 的 实践 项 目 之 一 ， 但 其 实施 的 成 本 之 高 是 无 法 忽视 的 。 而 如 果 能 确保 
静态 分 析 自 动 化 ，review 时 就 可 以 忽略 对 编码 规则 等 细节 的 检查 ， 从 而 
对 更 为 本 质 的 内 容 进 行 review。 

面向 Java 这 样 的 静态 类 型 语言 的 静态 分 析 工 具 还 是 比较 多 的 ， 但 孟 
向 动态 类 型 语言 的 工具 就 比较 少 了 。 特 别 是 要 通过 Jenkins 来 统计 的 话 
就 更 难 了 。 即 便 如 此 ， 还 是 有 面向 JavaScript 的 JSLint "等 几 款 可 以 通过 
Jenkins 进行 统计 的 工具 ， 可 以 根据 需求 试 着 找 一 下 。 如 果 没 有 的 话 ， 自 
行 制 作 也 不 失 为 一 个 不 错 的 方法 。 















































































































































5.4.9 配置 通知 





最 后 对 build 结果 的 通知 进行 配置 。 包 括 插件 在 内 ，Jenkins 提供 了 
多 种 通知 build 结果 的 手段 。 可 以 通过 邮件 、IRC、Twitter 来 通知 ， 还 可 
以 利用 称 为 XFD (eXtreme Feedback Device ) 的 硬件 进行 通知 。 特 别 是 
XFD， 经 过 精心 的 设计 ，XFD 在 build 失败 时 会 鸣 响 警报 或 发 射 玩具 火 
箭 等 ， 非 常 有 趣 。 

这 里 讲解 一 下 通过 邮件 来 通知 的 方式 。Jenkins 默认 提供 了 邮件 通知 
的 功能 ， 只 需要 在 “构建 后 操作 ”中 选择 “E-mail Notification” 即 可 
(图 $.14 )。 









































中 http:/wwwjslinticomy 
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5.14 ”邮件 通知 的 设置 


构建 后 操作 





E-mail Notification © 
Recipients | devteam@shanon .cojp 
Whitespace-separated lst of recipiont acdresses May relorence buid parameters ka $PARAN E-mail wil be sent when a build ials bacomes unstable or retums to stablo. 
每 次 不 稳定 的 构建 都 发 送 邮件 通知 
单独 发 送 邮件 给 对 构建 造成 不 良 影 响 的 责任 人 © 


在 收 件 人 〔 Recipients ) 处 填写 邮箱 地 址 后 ， 在 build 失败 或 者 失败 
的 build 被 修复 时 就 会 收 到 邮件 通知 。 可 以 在 此 配置 团队 的 邮件 列表 等 。 
默认 设置 中 选中 了 “每 次 不 稳定 的 构建 都 发 送 邮 件 通知 "， 这 样 一 来 ， 
在 连续 build 失败 的 情况 下 ， 每 次 都 会 收 到 通知 邮件 。 通 常 这 样 设置 是 
没有 问题 的 ， 但 如 果 项 目 经 常 build 失败 、 状 态 不 好 ， 解 除 这 个 选项 就 
不 会 每 次 失败 时 都 收 到 邮件 了 。 但 这 里 并 不 建议 解除 该 选项 。 

如 果 选 中 “单独 发 送 邮 件 给 对 构建 造成 不 恨 影响 的 责任 人 ”， 那 么 
除了 刚才 在 收 件 人 处 配置 的 邮箱 地 址 之 外 ， 还 会 给 造成 build 失败 的 当 
事 人 发 送 邮 件 。 使 用 该 功能 需要 预先 为 Jenkins 配置 邮件 服务 器 。 
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5.5 “CI 的 运用 


Jenkins 的 配置 完成 后 就 可 以 实施 CI 了 。 这 里 我 们 来 说 一 下 CI 运用 
上 的 小 窍门 以 及 同 版 本 管理 系统 和 缺陷 管理 系统 的 协作 。 





5.5.1 build 失败 了 该 怎么 办 





开始 实施 CI 后 会 由 于 某 人 的 提交 而 造成 build 出 错 。 这 里 所 说 的 
build 出 错 是 指 代码 无 法 编译 ( compile )、 静 态 分 析出 现 错误 、 测 试 失 败 
等 现象 。 

那么 build 失败 的 话 应 该 怎么 办 呢 ? 造成 build 失败 的 当事人 应 该 对 
提交 进行 修改 ， 避 免 build 再 度 失 败 。 而 其 他 的 团队 成 员 应 该 做 些 什么 
呢 ? 这 个 根据 版 本 管理 系统 运用 方式 的 不 同 而 有 所 差异 。 





























@…… Subversion 等 中 央 集 权 型 版 本 管理 系统 的 情况 


build 失败 的 话 ， 从 那 一 刻 起 就 不 得 不 禁止 在 相同 代码 库 的 相同 分 文 
上 进行 开发 的 所 有 成 员 的 提交 。 对 于 全 员 都 在 同一 代码 库 上 进行 开发 的 
中 央 集 权 型 版 本 管理 系统 来 说 ， 在 造成 失败 的 提交 上 再 县 加 其 他 人 的 提 
交 的 话 ， 修 改 会 变 得 更 为 困难 。 最 糟糕 的 情况 是 在 造成 build 失败 的 提 
交 之 上 又 大 加 了 其 他 有 问题 的 提交 ， 这 样 的 事情 也 是 存在 的 。 























@…… Git 等 分 布 式 管理 系统 的 情况 


Git 的 情况 下 原则 上 和 Subversion 一 样 。 从 build 失败 的 那 一 刻 起 就 
要 禁止 在 相同 代码 库 的 相同 分 支 上 进行 开发 的 所 有 成 员 的 提交 ， 这 是 比 
较 简 便 的 运用 方法 。 采 用 第 3 章 中 介绍 的 git-flow 这 样 的 工作 流程 ， 全 
员 向 同一 个 代码 库 进 行 Push 的 话 ， 就 需要 禁止 提交 。 

但 是 像 github-flow 这 样 ， 各 个 成 员 拥 有 自己 的 代码 库 ， 通 过 发 送 
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Pull Request 进行 修改 的 话 ， 就 没有 必要 禁止 全 员 提 交 了 。 只 需要 在 Pull 
Request 被 发 送 到 中 央 代码 库 时 确认 该 Pull Request 和 中 央 代码 库 合 并 后 
的 代码 是 否 能 够 通过 build 即 可 。 这 也 是 比较 可 行 的 方法 。 








-一 专栏 ”造成 build 失败 后 的 惩罚 游戏 


笔者 所 在 的 公司 中 ，build 失败 时 会 向 全 体 成 员 发 送 邮 件 ， 并 且 
规定 从 收 到 邮件 后 到 build 恢复 正常 为 止 禁止 全 员 的 提交 。 
为 了 让 大 家 知道 是 谁 造 成 了 build 失败 ， 造 成 build 失败 的 人 要 
戴 一 项 大 的 礼服 帽 作为 惩罚 游戏 。 直 到 build 修复 为 止 ， 要 一 直 戴 着 
这 项 帽子 ， 公 司 内 部 会 议 也 只 能 戴 着 帽子 参加 ( 图 5.c )。 因 为 这 样 非 
党 丢脸， 所 以 大 家 在 提交 时 会 加 倍 小 心 。 但 如 果 做 过 了 头 就 变 得 像 追 
查 犯 人 一 样 ， 导 致 开发 人 员 黑 首 轩 尾 ， 不 愿意 从 续 挑战 性 的 新 功 
能 开发 。 因 此 要 保持 在 开玩笑 "的 程度 ， 让 团队 开发 顺利 地 推进 。 






















































































































































































































































































5.c ” 戴 大 礼服 帽 的 惩罚 游戏 




















四 开玩笑 是 国 队 开发 中 的 重要 元 素 。 它 能 够 促进 团队 成 员 之 间 的 交流 ， 使 项 目 顺 

利 进 展 。 可 以 采用 之 前 提 过 的 XFD， 或 者 使 用 Jenkins Emotional Plugin ( https:// 

wiki.jenkins-ci.org/display/JENKINS/Emotional+Jenkinst+Plugin ) 这 款 会 根据 build 
结果 改变 Jenkins 先生 的 表情 的 插件 ， 都 是 非常 有 趣 的 。 
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@…… 测试 后 合并 


本 章 在 介绍 TravisCI 时 介绍 过 ， 结 合 GitHub 和 TravisCI 能 够 实现 
测试 通过 后 再 提交 。 其 实 Jenkins 借助 GitHub pull request builder plugin 
插件 也 可 以 实现 同样 的 功能 。 这 款 插件 可 以 实现 的 功能 和 TravisCI 基本 
相同 。 插 件 的 配置 方法 可 能 稍 许 有 些 复杂 ， 具 体 请 参考 插件 的 帮助 网 站 
(英文 ) "。 这 里 只 做 简单 的 讲解。 














@ 安装 插件 
采用 和 Git Plugin 相同 的 安装 方法 “安装 GitHub pull request builder 
plugin 插件 即 可 。 





@ 在 GitHub 上 新 建 bot 用 户 
插件 自身 为 了 在 Pull Request 中 添加 各 类 评论 ， 需 要 bot 用 户 。 在 
GitHub 上 以 适当 的 名 字 新 建 用 户 ( 可 以 使 用 自己 喜欢 的 名 字 )。 











配置 Jenkins 的 系统 

输入 GitHub API 的 URL 以 及 GitHub 的 用 户 名 /密码 (图 5.15 )。 
除了 用 户 名 /密码 之 外 ， 也 可 以 输入 GitHub 的 Access Token (使 用 
Access Token 更 为 安全 ),。 在 Admin list 中 填写 作为 该 插件 的 Admin 的 
GitHub 用 户 的 列表 。Admin 可 以 在 Pull Request 的 评论 上 通过 和 bot 用 
户 的 对 话 进行 各 类 操作 。 其 他 的 项 目 保 留 默认 值 即 可 。 















































D https://wikijenkins-ci.org/display/JENKINS/GitHub+pull+request+builder+plugin 
@ 请 参考 5.4 节 。 
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5.15 ”GitHub pull request builder plugin 的 配置 





Github pull requests builder 





Admin list 


Accept to test phrase 
Test phrase 
Crontab line 


Access Token 





Github server api URL https://api.github.com 
Password IE 


Use comments to report results when updating commit status fails 贺 


Published Jenkins URL 
Request for testing phrase Can one of the admins verify this patch? 


Add to white list phrase .*add\W+to\W+whitelist.* 





*ok\W+to\W+test.* 
.*test\W+this\W+please.* 


/5 本 二 二 本 








@ 配置 各 个 任务 

对 各 个 任务 进行 配置 。 首 先 ,在 GitHub project 中 填写 对 象 GitHub 
代码 库 的 URL。 代 码 管理 系统 的 配置 选择 Git， 设 置 为 Repositories 的 
Repository URL。 “高 级 ”的 refspec 栏 填 人 +refs/pull/*:refs/ 





remotes/origin/pr/*。Branches to build 的 Branch Specifier 设置 为 
${shal}。 接 着 ， 在 “构建 触发 器 ”中 的 GitHub pull requests builder 这 


个 选项 上 打 钧 























。 在 Admin list 中 添加 这 个 任务 中 作为 Admin 的 用 户 信 


息 。 如 果 事 先知 道 发 送 Pull Request 的 用 户 的 话 ， 可 以 在 “高 级 ”的 











White list( 白 名 单 ) 中 输入 该 用 户 的 名 称 ， 这 样 配置 能 够 简便 很 多 。 














@ 实际 发 送 Pull Request 


试 着 发 送 
隔 5 分 钟 实行 
(图 5.16 )。 








Pull Request。 对 于 收 到 的 Pull Request， 中 央 代 码 库 会 每 
一 次 自动 build，build 结果 将 可 视 化 地 显示 在 GitHub 中 
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5.16 ”Pull Request 的 build 结果 





EC bstere4 wants to merge 1 commit into shonon:master from bustera4:odd_deno_confi- 181 mumMW #25 
曙 Discussion Commits 于 Files Changed 惠 


Added CS expo configuration 


+181additions 


-0 deletions 
No oneis assigned ©@ ~ No milestone @- 


@benzookapi @shot056 @ishiyamachiaki 
添加 了 CS expo 的 配置 文件 。 


请 review。 


© Determining merge status — Merged build started (Detalls) 
2 participants 过 


Cr buster84 added a commit 27 minutes ago 


buster84 Added CS expo configuration X czccdca 











可 以 确认 Pull Request 的 内 容 说 明 下 方 有 “Determining merge status 
-- Merged build started.(Details)” 这 样 的 信息 。 这 是 为 了 判断 是 否 能 够 合 


并 而 开始 执行 build 时 输出 的 消息 “。 点 击 Details， 会 迁移 到 相关 的 
Jenkins 画面 (图 5.17 )。 


5.17 ”在 Jenkins 中 确认 Pull Request 的 build 结果 





15 分 前 人 开始 


@ 构建 #17 (2013/04/25 18:51:29) i 1 分 43 9 on slavel 


Pull request #25 























游说 明志 变更 
居 编 引 编译 信息 = 
| No changes. 
时 本 炊 入 于 
— 4 Github pull request #25 of commit c2ccdca2aa6df7db37aa301fbbf6302c50edbadc automatically merged. 
总 Build Data 
o 
4 Revision: 67aa346b9c56209814ed6d23156e27d5063a7286 
辐 No Taas 
origin/pr/25/merge 

回 油 结 呆 So 

前 二 奖 物 建 测试 结果 ( 7 个 失败 /+7 ) 
你 证 次 models.process.JobManagerSpec.JobManager should::not allow to start a job if another job is not working 

but last job's starting time is in span time 





models.process.JobManagerSpec.JobManager should::allow to start a job when it is first time to start job 
models.process.JobManagerSpec.JobManager should: :allow to start a job also like this 
models.process.JobManagerSpec.JobManager should::allow to start a job if another job is not working and 
last job's starting time is not in span time 

models.process.JobManagerSpec.JobManager should::allow to start a job also like this 
models.process.JobManagerSpec.JobManager should::allow to start a job if another job is already started 
but the job name is different 

models.process.JobManagerSpec.JobManager should::not allow to start a job if another job is workin 





























马 Help us localize this page 更 新 : 2013/04/25 19:07:06 RESTAPI Jenkins ver. 1.489 








中 这 时 如 果 build 已 经 成 功 ， 就 会 出 现 “Good to merge”; 反之 如 果 失 败 的 话 ， 则 会 
出 现 “Failed” 这 样 的 消息 。 
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从 图 5.17 中 可 以 看 出 ，25 号 的 Pull Request 造成 了 7 个 测试 失败 。 
也 就 是 说 ， 这 个 Pull Request 不 能 合并 到 中 央 代 码 库 。 

这 样 的 运用 方法 能 够 防止 将 造成 build 失败 的 提交 合并 到 中 央 代 码 
库 。 因 此 能 够 避免 由 于 某 人 的 提交 有 问题 而 造成 全 员 作 业 停 止 这 样 的 
事态 。 











@ 添加 White list 或 重新 执行 build 

提交 Pull Request 的 用 户 如 果 还 没有 被 添加 到 Admin list 或 White 
list 的 话 ，build 则 不 会 被 执行 。 这 时 bot 用 户 会 在 Pull Request 中 添加 
“Can one of the admins verify this patch ?” 这 样 的 评论 。 对 此 ，Admin 将 
下 列 两 个 回答 之 中 的 任意 一 个 作为 评论 添加 在 Pull Request 中 ， 即 可 通 
过 bot 用 户 指 示 插 件 开始 执行 build。 


OK to test 





实施 build。 
add to whitelist 

将 建立 Pull Request 的 用 户 添加 到 White list 并 实施 build。 这 样 ， 从 
下 次 开始 ， 由 该 用 户 建 立 的 Pull Request 就 会 被 自动 build。 想 要 再 次 执 
行 已 经 执行 过 的 build 时 ， 只 需 添加 下 列 评论 即 可 “。 
test this please 

如 果 觉 得 上 述 过 程 麻烦 的 话 ， 只 要 在 最 初 的 任务 配置 阶段 将 用 户 添 
加 到 White list 中 即 可 。 男 外 ， 正 如 5.4 节 的 第 一 个 专栏 中 所 提 到 的 那 
样 ， 要 想 使 用 该 插件 ， 就 需要 支持 GitHub 向 Jenkins 发 送 请 求 的 网 络 结 
构 。 添 加 只 允许 GitHub 的 也 地址 发 出 请 求 的 IP 过 滤 规 则 ， 这 样 安全 性 
方面 就 不 用 担心 了 。 即 使 不 使 用 GitHub ， 也 可 以 采用 相同 思路 的 运用 策 
略 。Jenkins 的 作者 川口 耕 介 将 这 样 的 思路 称 为 “验证 后 合并 ””。 只 向 主 
分 支 合 并 经 过 验证 的 、 没 有 问题 的 修改 ， 由 此 来 避免 因 某 人 提交 造成 
build 失败 ， 进 而 导致 全 体 人 员 作 业 停 止 的 事态 ， 团 队 开发 的 生产 效率 也 
能 更 上 一 层 楼 。 


















































四 这 些 命令 语句 自身 都 可 以 在 图 5.15 的 配置 中 修改 。 
@) 事实 上 Subversion 也 支持 验证 后 合并 的 运用 方式 。 
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5.5.2 ”确保 可 追溯 性 





build 失败 或 发 生 问题 时 ， 有 问题 的 build 是 哪 次 提交 产生 的 ， 该 提 
交 原 本 是 为 了 解决 怎样 的 问题 等 ， 如 果 能 够 妃 溯 上 述 信息 ,那么 对 于 实 
际 的 运用 是 很 有 帮助 的 。 

通过 Jenkins 和 缺陷 管理 系统 以 及 版 本 管理 系统 的 协作 ， 能 够 确保 
各 类 信息 的 可 追溯 性 ， 实 现 项 目的 可 视 化 (图 5.18 )。 


图 5.18 ”确保 可 追溯 性 


























7 集成 测试 

部 署 OK 的 
build 厂 
be 收 测试 









































反映 测试 
结果 





























@…… 关联 build 和 提交 


阅读 到 这 里 并 实施 了 CI 的 话 ，Jenkins 和 版 本 管理 系统 的 关联 应 该 
已 经 配置 完成 了 ”", 当然 不 配置 的 话 也 无 法 实施 CI。 也 就 是 说 , 只 要 通过 
Jenkins 实施 CI， 就 能 将 build 和 提交 明确 地 关联 起 来 。 大 致 的 印象 如 图 
5.19 所 示 。 

















© 


请 参考 5.4.4 节 的 内 容 。 
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5.19 ”用 Jenkins 关联 build 和 提交 










































允许 自动 刷新 
修改 记录 
#23 (2013/04/26 18:41:35) 
(cammit eS0e68a58d50819dc57b38beb377alccacfbdefe) — okumura.y / githubweb 
commit: c2ccdca2aa6dfzdb37aa301fbbf6302c50edbadc) 一 okumura y / qithubweb 
and eg eve (camit 0a6ac26(a7147706eb3113bzsf33683408ISTeegj dkurmuta'y / ithubwed 
六 生 成 #14 (2013/04/24 19:21:41) 
沉 刘 定 二 Aad Job seheduler om sc4Bce2e20574f6b0a0b19d9f811e36b) 一 ray / githt 
图 sam Eee CEI Adehy2ane dle Hae 1c9 34517123) ”akunuray /aithubweb 
围 swe took toe #9 (2013/04/18 19:41:48) 
围 stpomme tog add alldo\ controller a je20c: a72337b77a2e56a37c6377) my/ shoeb 
2. Ad 612) 一 akumura y / githubweb 

[a [3 Fx cab23270a8 rr 
上 E | 4 typo (commit, e143449e958eae329416d35421717eebe146d9)— okumuray /gith 
@ #23 2013/04/26 18:41:35 5. Change tmp director ps of dleting Un cs (cominit! 20514034200104647dee30e4sbcfa6da6808) — okumuray / othubweb 

2013/04/26 18:21:36 ( /04/ ) 
@ #2 2013/04/26 18:21:36 #5 (2013/04/15 16:11:48: 
@ #21 2013/04/26 10:31:29 

1. Added installation steps (commit: 7b675b3ea71dd21143a8d7d3100022750e829307) — okumura.y / qithubweb 

@ #20 2013/04/25 20:35:22 
@ #19 2013/04/25 20:33:04 
@ #18 2013/04/25 20:31:20 
@ #17 2013/04/25 18:51:29 

pul request zas 





如 图 5.19 所 示 ， 在 Jenkins 的 build 号 、Git 的 提交 编号 以 及 提交 者 
这 些 信息 之 间 建 立 起 了 关联 。 例 如 ， 可 以 看 出 所 3puild 和 3 个 提交 有 
关 。 另 外 ， 从 图 5.19 中 还 可 以 看 到 有 代码 库 浏览 器 (本 例 为 GitHub ) 
的 链接 ， 可 见 build 和 代码 的 Diff ( 差分 ) 之 间 的 关联 也 建立 起 来 了 。 
这 样 ， 即 使 build 失败 ， 也 能 够 顺 蕨 摸 瓜 地 和 型 清 是 谁 造成 的 、 修 改 
的 内 容 是 什么 。 这 一 功能 在 应 对 问题 等 时 候 是 非常 有 用 的 。 


e…… 关联 缺陷 管理 


如 果 Jenkins 已 经 和 缺陷 管理 以 及 版 本 管理 进行 了 关联 的 话 ，build 
和 提交 ， 以 及 提交 和 相关 问题 票 号 之 间 就 都 建立 起 了 相应 的 联系 。 
这 次 以 nulab 公司 的 Backlog 产品 为 例 进 行 说 明 。 如 同 在 第 4 章 提 
到 的 ，Backlog 是 集 缺 陷 管 理 系统 和 版 本 管理 的 代码 库 浏览 絮 于 一 体 的 
SaaS 系统 。 想 要 关联 Jenkins 和 Backlog 的 话 ， 首 先 需 要 安装 Backlog 
插件 。 和 Git 插件 一 样 ， 请 从 管理 插件 处 进行 安装 。 安 装 后 打开 各 任务 
的 配置 画面 ， 会 出 现 如 下 输入 框 ， 请 输入 Backlog 工程 的 URL、 用 户 
ID (User ID ) 和 密码 (Password ) ( 图 5.20 )。 同 时 在 Backlog 中 也 需要 
进行 配置 ， 将 版 本 管理 系统 的 提交 记录 和 问题 票 关 联 起 来 。 












































Ht 

















图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 











5.5 Cl 的 运用 | 195 











图 5.20 ”Jenkins 和 Backlog 的 关联 

















回 Backlog 

Backlog URL https://shanonpj.backlog.jp/projects/SSAPI 间 
UserID ikeda 上 间 
Password | EE » 











Backlog 能 够 和 Subversion 以 及 Git 这 两 个 版 本 管理 系统 进行 协作 。 
结合 使 用 Backlog 和 Subversion 的 情况 下 ， 要 选中 图 5.21 中 的 “提交 信 
息 连接 课题 ”选项 。 











5.21 ”Backlog 和 Subversion 的 关联 





项 目 设 置 
编辑 项 目 ( 假如 您 不 是 此 项 目 成 员 ， 某 些 功能 链接 将 失效 。 ) 
强项 目 设置 日 
编辑 项 目的 基本 设置 Subversion 设 置 
成 员 
主题 了 此 项 目 不 使 用 Subversion 
Subversion" 标签 将 不 显示 于 各 页 面 。 
种 类 
类 别 人 © 在 贝 格 乐 建立 存储 库 (Repository) 
此 链接 【httpsylysylife .backiogtoolcorysvn/TRANS_TEAMWORK/]】 是 Subversion repository。 
有 提交 信息 连接 课题 
提交 信息 将 作为 相关 课题 的 新 评论 ， 若 信息 中 含有 某 些 关键 字 (如 : jcloses,#fixes 等 ) ， 课 题 的 状态 将 自动 更 新 。 
Subversion 
Git 使 用 外 部 Repository (Premium 或 以 上 方案 ) 











Git 的 话 如 图 5.22 所 示 。 





图 5.22 ”Backlog 和 Git 的 关联 


项 目 设置 
编辑 项 目 ( 间 候 如 您 不 是 此 项 目 成 员 ， 某 些 功能 链接 将 失效 。 ) 





项 目 设置 
编辑 项 目的 基本 设置 


成 员 Repostores | 设置 


Git 设 置 








种 类 回 连接 课题 和 关键 字 
类 别 提交 信息 将 作为 相关 课题 的 新 评论 ， 若 含有 某 些 关键 字 (如 : #icloses,#fixes 等 ) ， 课 题 的 状态 将 自动 更 新 。 











这 次 使 用 了 Subversion 作为 版 本 管理 系统 。 至 此 配置 就 完成 了 。 在 
这 种 状态 下 ， 将 问题 票 号 添加 到 提交 记录 中 提交 并 执行 build，Jenkins 
上 就 会 生成 如 图 5.23 这 样 的 修改 记录 画 函 




















0 
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5.23 ”在 Jenkins 上 和 Backlog 的 Subversion 进行 关联 




















Jenkins | SsApiCommon_Trunk 
重 返回 到 工程 修改 记录 
#296 (201 22 20:11:32 
蔚 consoe Output 298. 到 场 统计 API 的 GET 方法 的 实现 一 suzuki / Backlog 
[SE: #288 (2013/05/17 12:38:38) 
基隆 本 次 生成 297. 在 mailsender.get 中 添加 取得 post 方法 预约 发 信 时 间 和 时 和 分 一 suzuki / Backlog 
区 Medues 296. 消息 内 容 和 测试 数据 的 修正 一 suzuki / Backlog 
大 Backog 


#284 (2013/05/16 21:11:32) 
295. 取得 compaign 项 目 配置 信息 的 APV 取得 sub campaign 项 目 配置 信息 的 APV 取得 演讲 者 项 目 配置 信息 的 AP 


i #280 (2013/05/16 15:51:33) 


园 subversion Poting Lo 
力 “aasoa report 





人 Buid History ( 时 加 呈 序 ) 
PE pr 294 将 SsApiCommon 版 本 更 新 至 0.16 一 suzuki/ Backog 
@ #308 2013/05/29 10:18:43 #279 (2013/05/16 15:11:33 
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291. 添 加 maitemplate 的 get、post 和 put 方法 一 suzuki/ Backlog 














suzuki/ Backlog 














点 击 Backlog 的 链接 ， 迁 移 到 如 图 5.24 所 示 的 代码 库 浏 览 器 。 这 里 


能 看 到 Diff 等 信息 。 


5.24 ”Backlog 的 代码 库 浏 览 








修改 231 - 回 
和 返回 上 一 页 
<< 上 一 个 修改 ( r230 ) 下 一 个 修改 ( r232 ) >> 
修改 概要 





更 新 时 间 2011/12/15 18:18 
更 新 者 shanon] 池田 尚 史 夫 + 
评论 。 SSAPI-21 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
#fixed 








Commit 会 影响 路 径 名 字 





: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Activity.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

: 5sApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Application.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Session.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Visitor.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 

: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorApplication.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 
: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorFile.java 【显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 




















从 代码 库 浏览 器 上 可 以 确认 间 题 票 号 及 其 链接 。 图 5.24 中 的 
“SSAPI-21” 部 分 就 是 问题 票 的 链接 ， 点 击 链接 就 能 前 往 如 图 5.25 所 示 





的 对 应 的 题 票 。 
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5.25 ”能 够 链接 到 对 应 的 问题 票 








SSAPI-21 | 侈 | | 提交 日 期 2011/12/15 15:10:28 | 开始 日 : 2011/12/15 | 期 限 日 : 2011/12/15 


给 SsApiCommon 添加 重新 取得 Token 的 功能 



























































种 类 Task 优先 级 ” 中 

类 别 结束 理 

版 本 状态 ”结束 

里 程 碑 责任 者 【shanon 】 池 田 尚 史 
预计 使 用 时 间 实际 使 用 时 间 























详细 Dm) 【 shanon 】 池 田 尚 史 “ 旨 











只 显示 注释 ( 3 ) 









































2011/12/15 18:18 Lm) 【 shanon 】 池 田 尚 史 号 | 引用 | 编辑 | 删除 会 
o 状态 ; 未 处 理 -> 处 理 完毕 
9 提交 : r231 


SSAPI-21 
添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 














像 这 样 ，Jenkins 提供 了 和 Backlog 等 各 种 缺陷 管理 系统 进行 协作 的 
插件 。 这 次 以 Saas 形式 提供 的 、 便 利 的 Backlog 为 例 进 行 了 说 明 。Trac 
和 Redmine 也 提供 了 Jenkins 的 插件 ， 可 以 实现 完全 相同 的 配置 。 请 以 
实现 高 可 追溯 性 的 CI 为 目标 ， 有 效 地 加 以 运用 。 
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5 6 本 章 总 结 
” ”借助 Cl 能 够 实现 的 事情 


本 章 介绍 了 CI 的 实践 ， 并 对 实现 CI 所 必需 的 编译 工具 、 测 试 
架 、CI 工 具 进行 了 说 明 。 通 过 导入 CI， 能 够 时 常 实施 编译 和 测试 ，; 
样 就 能 既 迅 速 又 准确 地 获得 开发 内 容 的 反馈 ， 在 保持 应 用 程序 高 质量 上 
同时 ， 还 有 助 于 提高 开发 速度 。 

另外 ， 通 过 在 CI 服务 器 上 对 各 类 信息 进行 统一 的 管理 ， 就 既 能 确 
保 可 追溯 性 ， 又 能 够 推进 项 目的 可 视 化 。 借 助 CI 还 可 以 构筑 和 代码 库 
完全 对 应 的 、 能 够 时 常 保 持 完 全 运行 状态 的 应 用 程序 环境 ， 比 起 临近 发 
布 时 才 开 始 提心吊胆 地 耗费 长 时 间 进 行 编译 ， 这 是 很 大 的 进步 。 

那么 , 在 CI 之 后 还 有 什么 呢 ? 借助 CI 我 们 已 经 确保 了 代码 库 中 应 
用 程序 能 够 一 直 正 常 运行 。 而 如 果 能 将 代码 库 中 的 程序 直接 发 布 到 正式 
环境 ， 那 么 应 对 市 场 变化 的 速度 不 就 能 大 大 提升 了 吗 ? 

实现 上 述 想法 的 实践 就 是 持续 交付 ( CD，Continuous Delivery )。 第 
6 章 将 介绍 实现 CD 所 必须 要 做 的 事情 以 及 运用 上 的 一 些小 技巧 。 
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6.1 应 该 如 何 部 署 


用 一 句 话 来 概括 这 一 章 就 是 “所 有 部 署 相 关 的 作业 都 应 该 实现 自动 
化 "。 这 里 所 说 的 部 署 是 指 将 开发 的 代码 以 能 够 使 用 的 状态 放置 到 服务 
器 上 这 一 连 串 行为 。 把 WAR 文件 上 传 到 Tomcat 等 容 需 上 的 行为 也 可 称 
为 部 署 ， 但 这 个 是 更 为 广义 上 的 部 署 。 本 章 和 《持续 交付 》 在 内 容 上 虽 
然 有 重复 的 部 分 , 但 本 书 更 为 简明 易 懂 ， 笔 者 将 根据 自身 过 去 数 百 次 的 
部 署 经 验 ， 对 部 署 的 自动 化 进行 简单 的 说 明 。 重 点 对 部 署 的 最 优 方法 以 
及 简化 部 署 的 工具 的 使 用 方法 进行 讲解 。 






































6.1.1 部 署 自动 化 带 来 的 好 处 


实现 部 署 的 自动 化 会 带 来 哪些 改善 ? 首先 我 们 来 说 一 下 自动 化 部 署 
的 优点 。 


e…… 细 粒 度 、 频 繁 地 发 布 可 以 使 风险 可 控 


部 署 工作 本 身 就 不 是 一 件 轻松 的 事情 ， 如 果 几 个 月 才能 实施 一 次 间 
署 的 话 ， 程 序 就 会 有 多 个 部 分 产生 大 量 的 代码 修改 。 所 有 的 修改 都 能 正 
常 运行 自然 最 好 ， 但 现实 往往 并 非 如 此 。 考 虑 到 多 个 较 大 的 故障 同时 发 
生 所 造成 的 严重 后 果 ， 这 的 确 是 个 环 手 的 问题 。 而 如 果实 现 部 署 的 上 自动 
化 和 简易 化 ， 就 能 够 频繁 地 实施 部 署 ， 由 此 对 故障 规模 进行 控制 就 成 为 
了 可 能 。 






































@…… 能 尽快 地 获得 用 户 的 反馈 
部 署 得 越 时 ， 就 能 获得 越 多 的 用 户 反馈 。 尽 快 让 用 户 体验 新 开发 的 





( 《持续 交付 : 发 布 可 靠 软件 的 系统 方法 》David Farley、Jez Humble 著 ， 乔 梁 译 ， 人 
民 邮 电 出 版 社 ，2011 
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功能 ， 并 将 用 户 的 反馈 反映 到 下 一 阶段 的 开发 中 ， 知 能 形成 这 样 的 良性 
循环 ， 就 能 确立 市 场 的 优势 地 位 。 通 过 频繁 地 进行 部 署 来 回收 开发 的 投 
资 ， 才 可 能 产生 收益 。 

但 上 述 情况 的 前 提 条 件 是 : 必须 要 有 接受 用 户 的 反馈 并 反映 到 开发 
中 的 流程 。 具 体 来 说 包括 分 析 用 户 的 评论 、 意 见 以 及 系统 的 日 志 等 ， 本 
章 对 此 不 做 讲解 。 
























































e…… 团队 的 规模 可 控 


如 果 有 10 个 产品 ， 采 用 10 种 不 同 的 方法 手动 实施 部 署 的 话 会 怎么 
样 ? 每 个 产品 每 月 至 少 会 有 1 次 部 署 的 工作 ， 那 么 负责 部 署 的 运 维 团队 
就 需要 专门 的 人 员 来 实施 部 署 。 如 果 运 维 团队 的 人 手 不 足 ， 就 可 能 发 生 
新 产品 无 法 部 署 的 事态 。 而 如 果实 现 了 自动 化 部 署 ， 就 不 必 担 心 运 维 团 
队 的 人 手 不 足 ， 这 样 就 能 够 推出 新 产品 并 获得 用 户 反 馈 。 借 助 部 署 自动 
化 ， 团 队 人 数 的 规模 变 得 可 控 ， 因 此 可 以 放心 地 增加 产品 数量 。 
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部 署 的 自动 化 ( 持 








续 交 付 ) 











6.2 部 署 的 自动 化 








要 推进 部 署 的 自动 化 ， 束 要 解决 这 样 一 个 问题 ， 最 初 应 该 由 谁 着 手 














实施 ”如 何 实 施 ?” 其 实 答案 就 是 “由 想 实 施 部 署 自动 化 的 人 着 手 去 做 就 
行 了 ”。 昌 然 有 些 简单 粗 景 ,但 这 是 最 合理 的 解答 。 如 果 可 能 的 话 ， 最 
好 以 对 服务 器 及 网 络 相 关 事情 有 决定 权 的 运 维 团队 人 员 作 为 核心 成 员 。 



























































因为 不 可 避免 地 要 预先 做 好 环境 相关 的 准备 及 调整 ， 以 及 最 终 向 正式 环 
境 实施 自动 化 部 署 所 需 的 准备 工作 。 因 此 由 运 维 团队 的 人 员 来 牵头 着 手 
部 署 自动 化 ， 项 目的 进展 会 比较 顺利 。 


6.2.1 ”部署 自动 化 方面 的 共识 


文 撑 部 署 自动 化 的 技术 方 画 


( Ops ) 都 外 j 的 技术 。 关 于 这 一 点 ， 在 充分 协商 的 基础 上 ， 双 方 





E 够 使 



































i， 要 选用 开发 人 员 ( Dev ) 和 运 维 人 员 











达成 一 致 是 非常 重要 的 。 缺 少 任何 一 方 的 协助 ， 都 无 法 顺利 实现 部 署 


的 自动 化 。 因 为 音 


连 串 行为 。 














b 黎 是 指 从 开 





发 到 向 正式 环境 发 布 应 用 程序 为 止 的 一 


要 实现 部 署 的 自动 化 ， 需 要 全 体 团队 成 员 就 下 面 列举 的 4 个 项 目 达 
成 统一 认识 。 


@ 要 全 部 采用 版 本 管理 
@ 所 有 的 环境 都 要 用 同样 的 方式 来 构建 

@ 要 实现 发 布 工作 的 自动 化 ， 并 事先 进行 验证 
@@ 要 反复 多 次 进行 测试 

















@ 的 话 请 参考 第 3 章 的 版 本 管理 系统 。 不 仅仅 是 应 用 程序 的 代码 ， 
自动 化 相关 的 工具 、 数 据 库 、 测 试用 的 数据 等 都 应 该 作为 版 本 管理 的 对 
象 。 这 么 做 是 为 了 在 任何 时 候 都 能 够 恢复 到 过 去 的 任意 状态 。 
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我 们 要 意识 到 应 该 采用 相同 的 方法 来 构筑 开发 环境 、 








测试 环境 、 正 式 环 境 并 实施 发 布 。 这 是 在 推进 使 用 工具 进行 环境 构建 的 
过 程 中 必须 努力 做 到 的 要 点 之 一 。 即 便 是 手动 修改 了 1 行 配 置 ， 那 么 从 














这 一 刻 起 这 个 环境 


FP 就 混入 了 只 有 实施 修改 者 才 知 道 的 信息 。 





@@ 是 指 对 自动 化 部 署 实 施 持续 的 验证 ， 大 量 收 集 其 成 功 和 失败 的 信 
息 。 只 有 这 样 ， 向 正式 环境 实施 部 署 工作 的 准确 性 才能 得 到 保证 。 如 果 
能 够 做 到 上 述 全 部 内 容 ， 那 么 部 署 将 不 再 是 可 怕 的 事情 。 


6.2.2 ”部 署 流水 线 











实现 应 用 程序 的 build、 部 署 、 测 试 、 发 布 这 一 系列 流程 的 自动 化 称 





为 部 署 流水 线 ( dep 








loyment pipeline ) "(图 6.1 )。 


图 6.1 ”部 署 流水 线 
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、 工具 链 


Co chef 
Fablc | serverspec 


Fablic 
CE 
- RLogin/Tera 
Kickstart || Term Pro 















持续 集成 ( CI ) 
部 署 流水 线 

















@ 详细 内 容 请 参考 之 前 提 到 的 《持续 交付 》 
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e@…… 通 过 自动 化 加 快 部 署 速度 


我 们 的 目标 是 构建 这 样 的 部 署 流水 线 ， 并 通过 流水 线 的 循环 尽量 加 
快 部 署 的 速度 ， 同 时 还 必须 确保 正确 性 。 能 够 想到 的 最 差 情况 就 是 ， 从 
着 手 开发 到 发 布 经 历 了 数 月 一 数 年 之 久 ， 并 且 全 部 采用 手工 作业 ， 还 出 
了 差错 。 因 此 ， 在 部 署 流水 线 的 每 一 个 阶段 都 需要 全 体 团队 成 员 就 之 前 
提 到 的 部 署 自动 化 中 的 4 个 项 目 达成 统一 认识 。 

部 署 流水 线 的 每 个 阶段 都 有 着 各 种 可 以 使 用 的 工具 。 将 各 个 阶段 的 
工具 组 合 起 来 就 有 可 能 加 快 部 署 的 速度 。 

例如 ， 提 交 某 个 bug 的 修改 ， 由 提交 引发 持续 集成 的 运行 ， 顺 利通 
过 build 后 自动 部 署 到 测试 环境 ， 执 行 用 户 验收 测试 ， 通 过 测试 的 话 向 
正式 环境 实施 部 署 ， 在 正式 环境 上 实施 完 冒 烟 测试 "后 向 相关 人 员 发 送 
通知 。 到 此 为 止 的 所 有 流程 全 部 以 自动 化 的 形式 实施 。 上 述 流程 虽说 是 
比较 极端 的 例子 ， 但 确实 是 一 种 理想 形式 。 



























































e…… 任何 人 都 能 够 实施 部 署 是 很 重要 的 


实际 上 一 般 的 流程 是 当 提 交 积 累 到 一 定数 量 时 建立 分 文 ， 并 向 正式 
环境 实施 部 署 。 这 里 的 重点 是 部 署 流水 线 要 能 够 顺畅 地 运转 起 来 ， 在 间 
署 的 各 个 阶段 都 不 允许 有 因为 对 人 的 依赖 而 无 法 部 署 的 情况 。 理 想 的 情 
况 是 任何 人 都 可 以 实施 测试 ， 也 都 可 以 实施 发 布 。 

当然 考虑 到 访问 权限 和 审批 流程 的 问题 ， 最 后 按 下 发 布 按键 的 可 能 
是 特定 的 人 ， 但 并 不 是 说 这 需要 什么 特别 的 技术 。 换 而 言 之 就 是 : 不 需 
要 “发 布 技师 ”这 样 的 人 。 














6.2.3 ”服务 提供 工具 链 ( provisioning tool chain ) 





再 稍微 详细 地 对 图 6.1 中 给 出 的 工具 链 进行 一 下 说 明 。 大 致 可 以 分 
为 以 下 3 个 层次 来 考虑 ( 图 6.2 )。 





e@ 引导 ( Bootstrapping ) … 服 务 器 OS 的 配置 及 基于 虚拟 机 的 服务 





中 修改 代码 进行 build 时， 为 了 确认 build 是 否 正常 结束 而 进行 的 测试 。 
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器 安装 自动 化 的 相关 工具 

@ 配置 ( Configuration ) … 服务 器 及 中 间 件 的 配置 自动 化 工具 

@ 业务 流程 ( Orchestration ) … 代码 部 署 及 发 布 相关 的 服务 器 操作 
等 自动 化 工具 





以 上 3 个 层次 都 无 法 只 借助 1 个 工具 完成 所 有 人 处理， 只 有 集 齐 各 个 
层次 的 工具 并 实现 流水 作业 ， 部 署 流水 线 才 能 够 完成 。 
接着 我 们 来 介绍 几 款 在 各 层次 中 出 现 的 工具 。 


图 6.2 ”服务 提供 工具 链 















































服务 提供 工具 链 
立 用 程 条 pa = Capistrano 
Orchestration 应 用 程序 服务 的 部 署 自动 化 Fabric 
Puppet 
Configration 系统 配置 Boxen 
Chef 
Vagrant 
一 Kickstart 
Bootstrapping ey eh OS 的 安装 AWS ( EC2 ) 
人 | Cobbler 
VMware 
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6.3 引导 ( Bootstrapping ) 


引导 层 启 动 服务 器 的 OS， 使 服务 器 达到 我 们 所 需要 的 状态 。 这 个 
层次 包括 了 OS 的 种 类 、 磁 盘 容 量 以 及 网 络 配置 等 。 本 节 我 们 将 介绍 利 
用 服务 器 自动 化 安装 以 及 虚拟 化 技术 来 构建 环境 的 自动 化 工具 。 


























6.3.1 Kickstart 

















假如 你 所 在 的 开发 现场 添置 了 100 台 服 务 器 。 如 果 所 有 的 服务 器 都 
必须 设 定 同 样 的 磁盘 分 区 、 选 择 初始 化 安装 包 、 添 加 账户 以 及 设置 密 
码 ， 你 应 该 怎么 做 ? 
虽然 也 可 以 为 100 台 服 务 器 插入 安装 CD， 接 上 键盘 ， 一 台 一 台地 
配置 磁盘 分 区 ， 但 这 样 会 耗费 大 量 的 时 间 。 在 这 种 情况 下 ， 比 较 有 用 的 
工具 就 是 Kickstart。 





























Oe Kickstart 的 使 用 方法 











Kickstart 的 使 用 方法 是 : 安装 Linux 时 ， 在 kernel 参 数 中 加 上 
[ks=. ..] 这 样 的 选项 ， 就 可 以 从 USB、 外 置 硬盘 等 外 部 存储 器 或 
HTTP 、FTP 站 点 加 载 配置 文件 以 实现 安装 自动 化 。 

结合 PXE 启动 ,只 要 在 插 着 网 线 和 电源 线 的 状态 下 按 下 电源 开关 ， 
即 可 自动 完成 安装 。 并 且 不 仅 限 于 物理 服务 器 ，Kickstart 同样 也 可 用 于 
虚拟 机 的 安装 ， 因 此 通用 性 非常 好 。 


@…… 使 用 时 的 注意 事项 


需要 注意 的 是 ，Kickstart 只 能 用 于 Red Hat Enterprise Linux 系列 
( 以 下 简称 RHEL 系列 ) Linux 发 布 版 本 的 安装 。Debian GNU/Linux 系 



































(”Preboot Execution Environment， 网 络 启动 规格 的 一 种 。 
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列 的 Preseed 、Solaris 需要 使 用 JumpStart 这 种 其 他 的 安装 形式 。 

有 时 还 需要 根据 磁盘 容量 等 硬件 规格 的 不 同 来 设置 不 同 的 分 区 方 
式 。 在 引导 层 还 需要 意识 到 : 根据 所 用 的 工具 以 及 内 容 的 不 同 ， 可 以 选 
择 的 硬件 及 OS 等 也 是 有 所 差异 的 。 





























@ Kickstart 的 配置 示例 





下 列 代码 是 在 连接 网 络 的 状态 下 ， 安 装 并 启动 服务 器 的 简单 配置 示 
例 。Kickstart 的 内 容 是 将 CD 中 安装 向 导 所 问 的 问题 以 配置 文件 的 形式 
确定 下 来 。 


# Kickstart file automatically generated by anaconda. 




















install 
url --url=ftp://ftp.jaist.ac.jp/pub/Linux/CentOS/6/0s/x86 64/ 





1 指定 通过 FTP 来 安装 
lang a Un 8 
network --bootproto dhcp 
keyboard jp106 


zerombr 

clearpart --all 

part / --fstype ext4 --size=1 --grow ny 
1 分 区 配置 的 描述 。 设 置 为 qrow 的 话 分 9 

part /var --fstype ext4 --size=40960 





part /home --fstype ext4 --size=81920 

part /boot --fstype ext4 --size=400 

part swap --size=4096 

bootloader --location=mbr --driveorder=sda --append="crashkernel=auto rhgb 
quiet" 


timezone --utc Asia/Tokyo 





rootpw password @mastqeleld:Ab /eed 


User ==name=defaultuser -=-groups=Users ==password=userpass 





selinux --disabled 

firewall --disabled 

auteneemt sd --passalgo=sha512 
reboot 
repo --name="CentOS" ey 
Os/x86 64/ --cost=100 








Spackages 
@base 
@console-internet 


@core 
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@debugging 
@japanese-support 
@large-systems 
@network-file-system-client 
@server-platform 
@server-policy 
pax 

oddjob 

sgpio 

certmonger 

pam krb5s 
krb5-workstation 





#setup start +- 包 安装 完成 后 运行 shel1 脚 本 

spost --log=/tmp/anaconda-post.1log #--erroronfail 
function log mesg() { 

/bin/echo 

/bin/echo %POST: S$* 


b 


legRmesoan Start Server Setup, 


yum -y update 


log mesg "End server setup" 

/sbin/ifconfig | /bin/mail -s "Complete Server installation." user email 
address@example.com 

log mesg "END %POST SCRIPT" 


可 以 在 part 部 分 记载 分 区 配置 ， 在 user 部 分 建立 初始 用 户 并 设置 密 
码 。 还 可 以 配置 初始 安装 的 软件 包 ， 并且 在 安装 完成 后 自由 地 执行 shell 
脚本 。 这 里 用 yum 命 令 将 包 更 新 到 最 新 状态 ， 最 后 通过 mai1l 命 令 通 知 
ifconfig 命 令 的 执行 结 
































6.3.2 Vagrant 





开发 人 员 想 试 着 运行 下 最 新 代码 的 效果 时 ， 应 该 准备 怎样 的 环境 才 
好 呢 ? 

















@…… 为 每 一 位 开发 人 员 准 备 实体 电脑 比较 困难 


有 了 Kickstart 这 样 的 机 制 ， 为 实体 电脑 安装 OS 已 经 变 得 比较 简 
单 ， 但 如 果 为 每 一 位 开发 人 员 准 备 一 台 专 用 服务 器 的 话 ， 成 本 会 非常 
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高 。 另 外 还 有 物理 上 的 限制 ， 诸 如 没有 放置 的 空间 或 供电 不 足 等 问题 ， 
此 为 每 一 位 开发 人 员 提 供 一 台 服 务 咒 是 并 不 太 现 实 的 。 


























e@…… 使 用 虚拟 机 时 的 注意 事项 


解决 上 述 问题 的 办 法 之 一 就 是 将 测试 环境 构建 在 虚拟 机 上 ， 但 虚拟 
机 的 运用 、 操 作 多 少 需 要 具备 特殊 的 知识 ， 有 时 可 能 无 法 顺利 地 使 用 虚 
拟 机 。 

在 还 不 能 方便 地 使 用 虚拟 机 的 情况 下 ， 可 以 在 和 staging 环境 以 及 
手头 的 开发 环境 大 致 相同 的 运行 环境 下 checkout 最 新 的 代码 ， 试 着 确认 
程序 的 动作 。 但 各 个 环境 上 应 用 程序 所 依赖 的 模块 的 安装 版 本 存在 差 
异 ， 无 法 进行 验证 的 情况 也 是 党 有 的 。 

轻松 地 搭建 虚拟 机 ， 在 不 影响 当前 使 用 环境 的 前 提 下 就 能 够 进行 尝 
试 ， 安 装 所 需要 的 模块 并 实施 验证 。 下 面 就 来 介绍 一 下 能 够 实现 上 述 功 
能 的 软件 Vagrant。 





















































Wa 什么 是 Vagrant 


Vagrant "主要 是 通过 CLI ( Command Line Interface ) 来 操作 名 为 
VirtualBox2 的 虚拟 机 软件 的 工具 ， 由 Ruby 编写 。 这 里 说 “主要 ”， 是 因 
为 Vagrant 还 支持 VMware fusion 的 操作 ， 并 且 通 过 安装 插件 ， 还 可 以 
实现 类 似 于 AWS 的 Iaas 虚拟 机 的 操作 。 

Vagrant 不 需要 特殊 的 配置 ， 也 无 需 通过 鼠标 进行 复杂 的 操作 。 
VirtualBox 的 运行 环境 是 多 种 平台 的 ，Windows、Mac、Linux 等 只 要 是 
x86 架构 的 OS 都 可 以 运行 ， 因 此 能 在 多 种 OS 上 使 用 。 











@……Vagrant 的 安装 及 运行 方法 


旧版 本 (1.1 版 以 前 ) 的 vagrant 采用 gem 命 令 的 形式 来 安装 。 最 
新 版 本 以 RPM 或 DEB 包 的 形式 提供 ， 因 此 可 以 从 官网 "下载 并 安装 ， 

















中 http:/www.vagrantup.com/ 
©® https//www.virtualbox.org/ 
® http:/www.vagrantup.com/ 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 

















210 | 第 6 章 部 署 的 自动 化 (持续 交付 ) 




















安装 完成 后 即 可 开始 使 用 。 安 装 包 中 除了 Vagrant 的 代码 之 外 ， 还 包括 
Ruby 的 本 体 等 ， 因 此 不 会 和 安装 对 象 机 器 上 安装 的 Ruby 版 本 发 生 冲 
突 。 无 论 在 运行 有 怎样 的 应 用 程序 的 环境 上 都 能 方便 地 运行 。 

首先 就 让 我 们 访问 Vagrant 的 主页 ， 下 载 最 新 的 包 并 安装 。 安 装 完 
成 后 ， 从 VagrantBox 支持 的 OS 模板 列表 “确认 镜像 的 URL， 并 启动 虚 
拟 机 。 


$ vagrant box add centos http://developer.nrel.gov/downloads/vagrant- 
boxes/CentOS-6.3-x86 64-v20130101 .box 
$ vagrant init centos 














$ vagrant up 


只 需 这 几 步 操作 就 能 在 本 地 机 器 上 构筑 起 虚拟 的 CentOS 环境 。 执 
行 vagrant box add 命 令 的 部 分 就 是 将 OS 的 镜像 加 载 到 Vagrant 
中 。vagrant box add 支 持 多 种 镜像 ， 可 以 通过 运行 vagrant box 
1ist 命 令 来 确认 所 支持 的 镜像 列表 。 本 例 中 设置 了 CentOS 镜像 的 
URL， 其 他 如 Ubuntu、BSD 的 镜像 等 也 可 以 在 网 上 找到 。 

接着 让 我 们 试 着 登录 到 启动 后 的 虚拟 机 环境 。 

§ vagrant ssh 

Mac 和 Linux 环境 下 可 以 直接 登录 。Windows 环境 因为 没有 安装 
ssh 命 令 ， 所 以 无 法 通过 vagrant ssh 命 令 来 进行 。 

在 Windows 环境 下 登录 虚拟 机 的 方法 有 通过 Tera Term 等 终端 进行 
SSH 登录 ,或 者 在 Cygwin 环境 下 安装 ssh 命 令 ， 通 过 执行 vagrant 
ssh 命 令 进行 登录 。 

登录 后 可 以 对 环境 进行 各 类 验证 ， 如 果 不 再 需要 该 镜像 或 者 验证 失 
败 、 环 境 损 坏 的 话 ， 能 够 直接 删除 虚拟 机 。 


$ vagrant halt 
























































$ vagrant destroy 

像 这 样 ， 虚 拟 机 的 关闭 以 及 删除 也 可 以 通过 命令 轻松 地 实现 。 如 细 
还 想 在 新 的 干净 的 环境 上 进行 尝试 的 话 ， 只 需 执 行 vagrant up 命令 ， 
就 能 建立 新 的 虚拟 机 环境 ， 这 样 就 可 以 反复 地 进行 尝试 。 














‘i 


























OD http:/www.vagrantbox.es/ 
@) http://sourceforge.jp/projects/ttssh2/ 
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因为 Vagrant 是 由 Ruby 编写 的 ， 所 以 和 稍 后 介绍 的 Configuration 工 
有 具 Chef 的 配合 度 很 高 。 结 合 使 用 Vagrant 和 Chef， 能 够 反复 地 实施 环境 
的 构建 及 服务 器 、 中 间 件 的 配置 的 验证 。 比 起 在 本 地 环境 上 实施 上 述 处 
理 ， 建 议 准备 好 实施 CI 的 专用 环境 ， 具 体 的 内 容 将 稍 后 讲解 。 
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6.4 配置 ( Configuration ) 


6.4.1 不 使 用 自动 化 时 的 问题 


说 起 部 署 ， 人 们 往往 只 关注 发 布 工作 ， 但 其 实 服务 器 的 构成 管理 成 
本 也 非常 高 ， 这 一 直 是 一 个 问题 。 例 如 ， 某 应 用 程序 的 运行 环境 非常 复 
杂 ， 构 建 该 环境 需要 经 过 数 十 、 数 百 个 步骤 的 操作 ， 若 在 这 样 的 情况 下 
搭建 新 的 验证 环境 或 开发 环境 ， 会 有 怎样 的 问题 呢 ? 

笔者 所 经 历 过 的 某 个 应 用 程序 开发 中 ， 由 于 没有 人 负责 维护 构建 环 
境 的 手册 ， 只 提供 了 正常 运行 环境 的 访问 权限 ， 因 此 此 只 能 一 边 确认 此 
环境 上 安装 的 模块 及 中 间 件 的 配置 ， 一 边 构建 手头 的 环境 ， 白 白浪 费 了 
时 间 和 精力 。 
利用 虚拟 化 技术 ， 充 分 利用 作为 原型 的 虚拟 镜像 ， 的 确 能 多 少 跳 过 
一 些 中 间 纱 又， 但 即使 是 习惯 的 人 也 要 花费 几 小 时 ， 不 习惯 的 人 甚至 要 
花费 几 天 的 时 间 。 在 实际 的 开发 工作 中 ， 当 团队 人 员 增 加 或 发 生 工 作 交 
接 等 情况 时 ， 构 建 环 境 以 外 的 人 也 必须 能 够 在 该 环境 上 运行 应 用 程序 。 

耗费 了 一 定 的 时 间 终 于 构建 起 了 大 致 版 本 一 致 或 相同 的 运行 环境 ， 
程序 也 开始 运行 了 。 但 这 并 不 意味 着 各 个 环境 之 间 就 绝对 一 致 。 

若 在 这 样 的 环境 下 进行 开发 ， 就 会 出 现 “ 明 明 在 本 地 环境 上 能 够 正 
常 运行 ， 但 在 测试 环境 下 就 运行 不 了 ”的 问题 。 正 是 因为 模块 间 微妙 的 
版 本 差异 而 产生 了 bug。 

作为 上 述 问题 的 解决 方案 ， 可 以 使 用 配置 ( Configuration ) 相关 的 
自动 化 工具 ， 从 一 开始 就 采用 完全 相同 的 方法 对 环境 进行 安装 。 
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6.4.2 ”Chef 

















Chef 是 用 Ruby 编写 的 服务 器 配置 的 自动 化 工具 。 只 要 准备 好 名 为 
Cookbooks (食谱 ) 的 服务 器 构建 手册 形式 的 配置 文件 等 ， 就 能 按照 文 
件 所 记述 的 规则 为 服务 器 安装 软件 包 并 配置 中 间 件 。 

无 论 10 台 还 是 1 万 台 机 器 ， 只 需要 1 份 Cookbooks ， 就 能 构筑 起 符 
合 要 求 的 环境 。 像 Facebook 这 样 大 规模 的 运 维 也 同 样 使 用 Chef "。 

Chef 不仅 限于 大 规模 基础 设施 的 构建 ， 在 小 规模 基础 设施 构建 中 也 
能 发 挥 其 真正 的 价值 ， 因 此 即便 只 是 构建 1 台 机 器 的 环境 ， 也 可 以 对 其 
加 以 有 效 利用 。 


















































@……. Chef 的 构成 
Chef 的 运行 大 致 有 以 下 3 种 结构 。 
@ Chef Server ( 图 6.3 ) 


图 6.3 Chef Server 


Chef Server 





普 












通过 SSH 登录 





@@ 在 Chef 客户 端 上 运行 
* 取得 信息 


PP “执行 Chef 
Chef Server Chef 客户 端 








~ 
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图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 











214 | 第 6 章 部 署 的 自动 化 (持续 交付 ) 




















@ Chef Solo+ Knife Solo (图 6.4) 
Chef Solo (图 6.5) 


图 6.4 Chef Solo + Knife Solo 


人 Chef Solo& Knife Solo ) 


中 运行 Knife Solo 
. 发 送 Cookbooks 等 信息 
* 在 服务 器 上 运行 Chef Solo 
























图 6.5 Chef Solo 





人 Chef Solo 


采用 某 种 方式 获取 Cookbooks 等 


个 运行 Chef Solo 























Chen 


@ ~@ 所 使 用 的 Cookbooks 可 以 是 相同 的 。 在 由 1 一 2 台 服 务 器 
构成 的 环境 下 ， 可 以 从 Chef Solo 的 构成 方式 开始 ， 然 后 随 着 服务 器 台 
数 的 增加 ， 再 考虑 构建 Chef Server 的 环境 。 

为 了 学 习 Chef 最 基本 的 使 用 方法 ， 这 里 我 们 以 利用 Chef Solo 构建 
简单 的 Web 服务 器 环境 为 例 进 行 讲 解 。 

Chef 的 安装 和 Vagrant 一 样 可 以 采用 RPM 等 包 的 形式 进行 。 过 去 
是 通过 gem 命 令 进行 安装 的 ， 现 在 安装 包 中 还 提供 了 Ruby 的 本 体 ， 
此 不 会 和 OS 上 的 Ruby 发 生 版 本 依赖 等 问题 ， 能 够 直接 使 用 Chef。 
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Oe 目录 构成 和 文件 配置 
这 次 介绍 的 Chef 的 文件 和 目录 结构 如 图 6.6 所 示 。Chef 的 配置 文 
件 统称 为 Cookbooks ， 其 中 特别 是 Recipe 和 Template 起 着 主要 的 作用 。 
下 面 就 对 这 些 文件 逐个 地 进行 讲解 。 
图 6.6 ”Chef 的 文件 和 目录 结构 


国 chef-repo 


cookbooks 























virtualhost.conf.erb 


-{| node.json 


roles 
setup.json 


| solo.rb 


文件 和 目录 可 以 用 Chef 的 命令 行 接口 Knife 自动 生成 。 
$ knife cookbook create <Cookbook name> -o <output dir> 
这 样 就 能 自动 生成 必要 的 目录 结构 和 文件 ， 所 以 在 第 一 次 构建 Chef 
环境 时 ， 请 试 着 执行 上 述 命 令 。 但 是 指定 执行 对 象 Recipe 的 node.json 
等 配置 文件 需要 手动 生成 。 























@…. node.json 





这 个 文件 是 运行 Chef 所 必需 的 文件 。 这 次 node.json 中 记载 的 内 容 
参照 了 roles 目录 下 的 setup,json。 本 例 中 记述 的 是 执行 main 目录 下 的 名 
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为 default.rb 的 Recipe。 
{ 


Vune lest: 





"role[setup]" 二 参照 setup .json 


@.……. setup.json 


这 个 文件 就 是 配置 实际 的 Recipe 文件 的 地 方 ， 同 时 还 记载 了 
attribute。attribute 定义 的 变量 能 在 Recipe 文件 和 Template 文件 中 使 用 。 
{ 














namen setuplexample rogram 
"override attributes": { 
"apache": { 
"documentroot": "/var/www" + 能 够 在 recipe 或 Ltemplate 中 使 用 的 变量 
} 
}, 
nsonelas :enet .Rol 
"description": "Setup Examplep Program", 
Eee ol 


ran aliest :| 
"recipe [main: :default]" 
] 


© solo.rb 


这 个 文件 是 运行 Chef 所 必需 的 文件 。 记载 有 Chef 的 Cookbooks 的 
路 径 以 及 roles 的 文件 路 径 。Chef 是 用 Ruby 编写 的 ， 所 以 路 径 的 配置 同 
样 可 以 使 用 Ruby 的 File.expand_path。 

其 他 Ruby 的 语法 也 可 以 使 用 ,但 原则 上 作为 服务 器 构建 的 自动 化 
工具 应 该 尽量 将 所 使 用 的 语言 限制 在 Chef 的 DSL ( Domain Specific 
Language ， 领 域 语 言 ) 范围 内 。 


Cookbook path File.expand path("../cookbooks", FILE ) 
roleDpatho eiles expandpatn(u SHEST oe rE) 
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图 default.rb 


这 个 文件 就 是 被 称 为 Recipe 的 重要 的 配置 文件 。 在 package 那 一 行 
中 ，RHEL 系列 的 话 使 用 yum/rpm，Debian GNU/Linux 系列 的 话 使 用 
apt/deb 来 安装 Apache。 

template 是 在 部 署 配置 文件 时 使 用 的 ， 这 里 记述 的 处 理 是 在 Apache 
的 conf.d 目录 下 添加 新 的 配置 文件 。variables 用 于 在 ee 中 接收 
template 的 变量 。Chef 中 对 变量 的 处 理 是 非常 重要 的 。 通 过 记述 在 
attribute 中 ， 就 可 以 在 Recipe 和 template 中 作为 变量 使 用 ， attribute 
可 以 记载 在 几 个 文件 中 ， 并 且 有 着 各 自 不 同 的 优先 级 。 本 书 不 做 详细 的 
介绍 ， 只 是 提 一 下 优先 级 最 低 的 attribute/default.rb 文件 中 所 记载 的 是 作 
为 全 体 的 默认 值 ， 关 于 服务 器 的 作用 、 测 试 环境 、 正 式 环境 这 样 不 同 环 
境 的 环境 变量 ， 可 以 记载 在 Role 或 Environments 中 。 通 过 灵活 运用 
attribute， 能 够 调整 单个 Cookbooks 使 其 适用 于 各 种 环境 。 

在 directory 那 行 中 ， 昌 然 只 定义 了 新 建 指定 的 目录 ， 但 需要 注意 的 是 
这 里 用 到 了 定义 在 attribute 中 的 #{node[:apache] [:documentroot]} 
这 样 的 变量 。 

git 那 行 记 述 了 checkout 代码 库 的 master 分 支 到 指定 的 目录 下 。 通 
过 指定 action : sync，checkout 时 就 会 更 新 最 新 的 版 本 。 

在 service 那 行 中 ， 可 以 操作 中 间 件 的 启动 或 停止 。 这 里 定义 为 启动 
Apache。 
















































































package httpa 


template "/etc/httpd/conf.d/#{ENV['HOSTNAME'] } .conf" do 
1 根据 template 部 署 文件 





source "virtualhost.conf.erb" 
mode 0644 
OWner MEOOEY 
EOUp Mootn 
variables({ 
:env hostname => "#{ENV['HOSTNAME'] }", 
}) 


end 


directory "#{node[:apache] [:documentroot] }/#{ENVI['HOSTNAME'] }" do 
action :create @mipd::Eldded ?lB 
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end 


git "/var/www/#{ENVI['HOSTNAME'] }" do 
repository "https://github.com/example/program.git 





1 指定 任意 程序 的 Git 仓 库 


reference "master" 


action syne 
end 


service "httpd" do 


action :start + 启动 httpd 


end 


@…… virtualhost.conf.erb 


这 是 Recipe 中 指定 的 Template 文件 。 这 里 可 以 内 骸 attribute 或 
Recipe 文件 中 以 variables 形式 指定 的 变量 。 这 里 可 以 使 用 Ruby 的 erb 
模板 。 
<VirtualHost *:80> 
ServerAdmin serveradmin@<%- @env hostname %> 








DocumentRoot <%= @node.apache.documentroot %$>/<%= @env_ hostname 各 > 

ServerName <%$= @env hostname 和 > 

ErrorLog logs/<%= @env hostname %>-error log 

CustomLog logs/<%$= @env hostname %>-access log combined 
</VirtualHost> 


@…… Chef 的 运行 方法 和 运行 结果 


只 需 指定 node.json 和 solo.rb ， 就 可 以 运行 Chef Solo。 
$ sudo chef=solo =j node.json =¢ solo.rb 


执行 Chef 后 显示 如 下 结果 。 


[root@ip-=-10=132-=183=178 chefl]# chef-=solo =j node.json -=¢ solo.rb 
Starting Chef Client, version 11.6.0 





Gomilinog Cookbookee 
Converging 5 resources 
Recipe: main::default 
* package [httpd] action install < 安装 httpd 
= install version 2.2.25-1.0.amznl of package httpd 


* template[/etc/httpd/conf.d/ip-10-132-183-178.conf] action create 
- create new file /etc/httpd/conf.d/ip-10-132-183-178.conf 
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- _ update content in file /etc/httpd/conf.d/ip-10-132-183-178.conf from 

Done to 3cb554 二 部 署 Temp1ate 中 指定 的 文件 

--- /etc/httpd/conf.d/ip-10-132-183-178.conf 2013-09-22 
TOUS5 e278335727 20000 

+++ /tmp/chef-rendered-template20130922-6866-6hkxkf-0 2013-09-22 
10:12:45.290335967 +0000 

@@ -0,0 +1,8 @@ 

+<VirtualHost *:80> 





+ ServerAdmin serveradmin@ip-10-132-183-178 
十 DocumentRoot /var/www/ip-10-132-183-178 
+ ServerName ip-10-132-183-178 
+ ErroOrLog logs/ip-10-132-183-178-error 10og 
+ CustomLog logs/ip-10-132-183-178-access log combined 
+</VirtualHost> 1 文件 的 内 容 被 替换 成 了 attribute 的 值 
到 
- change mode from '' to '0644' 
= Change owner from "tt tO "wooGE' 
— onange group from uo (rode 


* directory[/var/www/ip-10-132-183-178] action create 
- Create new directory /var/www/ip-10-132-183-178 
1 建立 了 由 attribute 指 定 的 目录 
* git[/var/www/ip-10-132-183-178] action sync 
- clone from https://github.com/example/program.git into /var/www/ 
ip-10-132-183-178 < 使 用 git 命 令 进行 clone 
- Checkout ref 05e45129blfdlbbadl8c790fcd814ba36403cabl branch master 























* SerVice [httpd] action start 启动 httpd 
- Start service service[httpd] 


Chef Client finished, 5 resources updated 


使 用 这 个 Cookbooks 安装 Apache， 并 将 服务 器 配置 为 基于 名 称 的 
虚拟 主机 ， 在 DocumentRoot 中 通过 Git checkout 任 意 程 序 并 启动 
Apache。 到 此 为 止 的 处 理 就 实现 自动 化 了 。 如 果 是 checkout 后 能 够 立即 
使 用 的 应 用 程序 的 话 ， 那 么 通过 上 述 一 连 串 的 处 理 ， 环 境 构筑 应 该 就 能 
完成 了 。 















































@…… 使 用 Chef 的 优点 


可 以 看 出 用 Chef 的 DSL 编写 的 Cookbooks 非常 容易 理解 ， 学 习 成 本 
非常 低 。Cookbooks 是 用 Ruby 的 代码 编写 的 ， 因 此 还 可 以 进行 版 本 管 
理 ， 即 相当 于 在 版 本 管理 系统 上 保存 了 “服务 器 正常 状态 及 其 历史 记录 ”。 
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至 今 为 止 服务 器 的 结构 和 构建 管理 是 被 分 割 开 的 ， 通 过 对 Cookbooks 
进行 版 本 管理 ， 服 务 器 的 构建 有 了 历史 记录 管理 。 并 且 只 需 执行 Chef 
命令 就 能 实现 服务 器 构建 的 自动 化 。 也 就 是 说 ， 用 Ruby 的 代码 来 管理 
服务 器 状态 的 “Infrastructure as Code” 这 种 服务 器 管理 的 新 时 代 已 经 到 
来 了 。 











@…… 使 用 Chef 时 的 注意 事项 


使 用 Chef 时 有 一 点 需要 注意 ， 那 就 是 既然 已 经 使 用 Chef 对 服务 器 
进行 管理 ， 就 要 禁止 手动 构建 服务 器 ， 要 记 住 必须 使 用 Chef 进行 相关 
作业 。 如 果 手 动 地 安装 包 、 修 改 配置 等 ， 就 会 造成 服务 器 的 状态 和 
Cookbooks 中 的 定义 发 生 背 离 ， 而 为 了 达到 相同 的 状态 就 不 得 不 执行 多 
条 命令 ， 并 且 只 有 进行 此 操作 的 人 才 知 道具 体 的 内 容 。 但 如 果 将 上 述 操 
作 记 载 到 Cookbooks 的 话 ， 那 么 谁 都 可 以 通过 1 条 Chef 命令 将 服务 器 
配置 到 相同 的 状态 。 

从 构建 管理 的 角度 来 看 ， 不 使 用 Cookbooks 而 手动 构建 服务 器 也 是 
不 明智 的 。 全 部 采用 Chef 来 构建 环境 ， 即 使 最 初 只 需要 1 条 命令 就 能 
完成 构建 工作 ， 编 写 Recipe 文件 也 是 必要 的 。 虽 然 对 编写 Recipe 的 工 
作 感 到 焦躁 不 安 的 人 不 在 少数 ， 但 经 过 1 个 月 、1 年 的 时 间 后 ， 随 着 配 
置 修改 的 内 容 不 断 积累 ， 你 就 会 感受 到 使 用 Chef 所 带 来 的 好 处 。 




























































































@…… 使 用 Chef 的 时 间 点 


可 以 在 构建 开发 环境 的 阶段 ， 也 就 是 开始 开发 前 后 一 段 时 间 开始 使 
用 Chef。 使 用 和 开发 环境 、 测 试 环境 、 正 式 环境 同样 的 Cookbooks， 因 
环境 而 有 所 差异 的 配置 ， 可 以 全 部 通过 attribute 来 控制 。 

如 果 想 进一步 了 解 Chef 的 话 ， 可 以 参考 相关 资料 。 
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6.4.3 Serverspec 





本 什么 是 serverspec 


如 果 说 Chef 是 用 代码 来 管理 服务 器 环境 构建 的 工具 ， 那 么 
serverspec 就 是 对 服务 器 的 构成 进行 单元 测试 的 测试 框架 。 从 名 字 就 可 
以 看 出 ， 其 内 部 使 用 了 Ruby 的 BDD 框架 RSpec"。 

serverspec 虽然 不 是 直接 进行 配置 的 工具 ， 但 为 了 确保 Chef 等 通过 
代码 管理 服务 器 构建 的 工具 能 够 持续 地 正常 运行 ，serverspec 可 以 说 是 
必 不 可 少 的 测试 框架 。 


















































@……Serverspec 的 安装 


执行 如 下 命令 来 安装 serverspec 的 运行 环境 。 


$ gem install serverspec 
$ serverspec-init 
Select a backend type: 


1) SSH 
2) Exec (local) 


Select number: 2 
serverspec 支持 远程 服务 器 的 测试 ， 当 然 也 可 用 于 测试 本 地 服务 器 
(图 6.7 )。 执行 测试 需要 root 权限 ， 或 者 通过 sudo 来 执行 。 第 一 次 初始 
化 时 无 论 选 择 远程 主机 ( ssH ) 还 是 本 地 主机 ( Exec (local) ), 之 后 
都 可 以 进行 切换 ， 以 验证 为 目的 的 话 可 以 选择 “2”， 并 制作 测试 用 例 。 



































OD http:/rspec.info/ 
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图 6.7 ”serverspec 的 运行 环境 





serverspec 远程 主机 人 
中 SSH exec bash 
(Exec ( Local ) 













serverspec 服务 器 








远程 





serverspec via SSH… (1 | exec bash 





Exec ( Local ) … ® 








exec bash 

















。… 测试 文件 的 记述 方式 
执行 serverspec-init 命 令 , 会 自动 生成 文件 和 目录 (图 6.8 )。 


图 6.8 ”serverspec 的 目录 结构 










Rakefile 


spec 


localhost 


httpd_spec.rb 


spec_helper.rb 











localhost 目录 下 的 xxxx_spec.rb 文件 就 是 测试 用 例 。 假 设 在 执行 
前 提 到 的 Chef 的 Cookbooks 后 进行 测试 ， 我 们 来 试 着 制作 测试 用 例 。 
测试 的 内 容 包 括 确认 httpd 的 安装 及 启动 、 确 认 通 过 template 部 署 的 文 
件 是 否 存在 ， 以 及 对 文件 内 容 的 检查 。 


























和 httpd_spec.rb 


Beguneee eeemnenleey 


describe package('httpd') do 
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it { should be installed } + 检查 httpd 的 安装 


end 


describe service('httpd') do 
it { should be running  } + 检查 httpd 是 否 启动 





end 


describe port(80) do 
it { should be listening } < 检查 是 否 在 侦 听 80 端 品 


end 





check config = "/etc/httpd/conf.d/#{ENV['HOSTNAME'] } .conf" 
gesennbestaeleneek neontae 
了 十 { should etanle ) 二 检查 通过 template 部 署 的 文件 的 有 无 





it { should contain "ServerName #{ENV['HOSTNAME']}" } 
end 1 检查 文件 的 内 容 





gesernnbestueleneeckeeente 
it { should be mode 644 } 
it { should be owned by 'root' } 





Te snould pe rqrouped linton soo 
1 检查 文件 的 权限 以 及 所 有 者 









end 


除了 httpd 以 外 ,我们 再 试 着 添加 git clone 是 否 成 功 执 行 的 测 
试用 例 。 新 建 名 为 spec/localhost/git_spec.rb 的 文件 ， 如 下 所 示 。 

















| git_spec.rb 


Beveee Peemnelpen 


describe file("/var/www/#{ENV['HOSTNAME'] }") do 
it { should be directory } 
end 1 检查 git clone 是 否 成 功 执行 





@……. Serverspec 的 执行 方法 及 执行 结果 


执行 serverspec 的 测试 时 ， 在 Rakefile 层 执 行 下 面 的 命令 。 














$ rake spec 
执行 后 会 显示 如 下 结果 。 


/usr/bin/ruby -S rspec spec/localhost/git spec.rb spec/localhost/httpd 





spec.rb 
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Finished in 0.21744 seconds 
9 examples, 0 failures 


在 上 述 例子 中 ， 可 以 确认 9 个 测试 用 例 都 通过 了 。 测 试 失败 的 话 ， 
failures 的 数目 会 增加 。 如 果 要 输出 测试 的 详细 内 容 ， 可 以 设置 SPEC_ 


= 


OPTS="--format=documentation--colour" 这 样 的 环境 变量 ， 

















就 能 输出 RSpec 的 documentation format。 

要 注意 的 是 几乎 所 有 serverspec 的 测试 用 例 都 被 描述 为 了 “should 
be_xxxxx”， 一 看 便 知 这 是 在 对 服务 器 当前 的 状态 进行 检查 。 正 因为 可 
以 像 这 样 以 近似 自然 语言 的 形式 来 描述 测试 用 例 ， 所 以 测试 用 例 还 可 以 
被 当 作 服务 器 的 需求 规格 书 来 使 用 ， 制 作 非 常 简单 。 


























@…… serverspec 的 优点 





serverspec 的 特别 优秀 之 处 在 于 测试 的 执行 不 依赖 于 Ruby 的 运行 环 
境 这 一 点 。 测 试 代码 的 执行 是 通过 shell 命令 进行 的 ， 因 此 只 需要 在 运 
行 serverspec 的 服务 器 上 安装 Ruby 和 serverspec， 和 远程 服务 如 只 需要 能 
够 通过 SSH 登录 即 可 进行 测试 。 

serverspec 还 支持 多 种 OS， 可 以 对 RHEL 以 外 的 OS 如 Solaris、 
Debian GNU/Linux 进行 测试 。 

使 用 serverspec 能 够 对 任意 环境 应 有 的 状态 进行 检查 ， 配 合 Chef 一 
起 使 用 ， 就 能 够 放心 地 对 服务 器 进行 动态 的 配置 修改 。 








6.4.4 最 佳 实践 (其 1) 





在 讲解 Chef 时 提 到 了 “Infrastructure as Code” 这 个 单词 ,为 了 保 
证 代码 的 质量 ， 进 行 测试 是 很 重要 的 ， 并且 测试 还 必须 能 够 持续 地 执 
行 。 在 实现 了 服务 器 构建 的 自动 化 之 后 ，CI 的 实施 就 变 得 非常 重要 
(图 6.9 )。 
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图 6.9 Jenkins+Chef+serverspec+Vagrant 
















Jenkins 


























中 用 Vagrant 启动 干 
净 的 服务 器 实例 








(2)checkout Chef 的 Cookbook 和 
serverspec 的 测试 用 例 
Vagrant 全 寺 行 妈 日 
> ( 主 服务 器 ) (3) 执 行 Chef、 配 置 服务 器 
a (通过 serverspec 对 服务 器 的 状态 进行 测试 


















































让 我 们 试 着 结合 Jenkins+Chef+serverspec+Vagrant 来 实际 进行 上 述 
处 理 。 

Vagrant 提供 了 启动 虚拟 服务 器 时 执行 Chef 或 shell 的 机 制 ， 这 使 得 
构建 理想 中 的 环境 成 为 可 能 。 执行 vagrant init 时 会 生成 名 为 
Vagrantfile 的 虚拟 机 配置 文件 。 

在 Vagrantfile 中 添加 Chef Solo 或 shell 脚 本 等 服务 器 预 处 理 
( provisioning ) 的 相关 内 容 ， 在 第 一 次 执行 vagrant up 时 ， 这 些 处 理 
会 被 执行 。 除 第 一 次 启动 之 外 ， 可 以 通过 启动 时 添加 选项 vagrant up 
--provision, 或 者 在 虚拟 服务 器 启动 后 运行 vagrant provision 
来 执行 上 述 预 处 理 。 

在 GitHub 上 设 有 Chef 或 serverspec 的 代码 库 的 情况 下 ， 通 过 配置 
Webhooks， 并 设置 在 执行 Vagrant 的 预 处 理 的 过 程 中 启动 Jenkins 的 任 
务 ， 这 样 CI 环境 就 构建 完成 了 。git 代码 库 的 话 可 以 使 用 git hooks ， 几 
乎 所 有 的 代码 库 都 支持 在 commit 或 push 的 钧 子 中 执行 命令 。 

Vagrantfile 中 可 以 通过 关键 字 ijnline :来 提示 shell 脚本 。 下 面 的 


Vagrantfile 会 执行 git _ clone 命令 。 





















































QD http://git-sem.com/book/zh/v1/ 自 定义 -Git-Git 挂钩 
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@……Vagrantfile 


# -=*- mode: ruby -*- 
tv: set Et ruby 


# Vagrantfile API/syntax version. Don't touch unless you know what you're 
doing! 
VAGRANTFILE API VERSION = "2" 


Vagrant .configure (VAGRANTFILE API VERSION) do |config| 
eonfig vn bow oentosy 


Seonfuge vm oneovisuonm one 
inline: "curl -L https://www.opscode.com/chef/install.sh | bash" 


config.vm.provision "chef solo" do |chef | 


chefaddmrecipe mam 





1 设置 安装 git 和 serverspec 的 Recipe 文 件 


end 


end 


config.vm.provision "shell" ， 二 clone Cookbooks 和 测试 用 例 
inline: "rm -rf cookbooks serverspec && git clone git@github.com/my/ 
Cookbooks serverspec.git" 





contfio mn provislion "snelm 二 执行 clone 下 来 的 Cookbooks 
inline: "cd cookbooks serverspec/chef-repo && chef-solo -j node.json 
=G Solo. rb 


confughvm povisloneshem + 最 后 执行 sServerspec 


inline: "cd cookbooks serverspec/serverspec && rake spec" 


end 























通过 指定 add_recipe 在 主 服务 器 上 准备 好 Recipe 文件 ， 就 会 向 
虚拟 服务 顺 自 动 部 署 Recipe 文件 并 执行 Chef Solo (图 6.10 )。 还 可 以 通 
过 指定 cookbooks_path 来 使 用 定制 过 的 Cookbooks。 
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图 6.10 指定 add_recipe 的 情况 下 的 目录 结构 





a 
加 Vagrantfile 


cookbooks 








recipes 


ed 
| default.rb 























由 于 Vagrant 本 体 中 没有 提供 serverspec， 因 此 通过 inline :来 执 
行 。 或 者 也 可 以 使 用 名 为 vagrant-serverspec 的 插件 。 











@…… default.rb 


package "git" 

package "ruby" 

package "rubygems" 

gem package "serverspec" do 
action ,Linstaad 

end 


这 只 是 服务 器 构建 CI 的 一 个 例子 。 将 Vagrant 部 分 替换 为 Docker” 


等 技术 也 可 以 实现 相同 的 功能 ，Chef 部 分 也 可 用 puppet 来 代替 。 
serverspec 部 分 也 可 以 用 Cucumber Chef 或 Test Kitchen “等 测试 框架 。 这 





























里 的 重点 在 于 要 选择 团队 最 易于 使 用 的 、 适 合 自 己 的 工具 ， 而 不 是 局 限 














于 本 书 中 所 提 到 的 工具 。 这 对 于 持续 地 运行 这 些 工具 来 说 也 是 非常 重要 


的 ， 因 此 工具 的 选择 可 以 在 慎重 地 交流 沟通 后 再 决定 。 























6.4.5 ”最 佳 实践 (其 2) 

















因为 重视 硬件 性 能 或 受 服务 合同 上 的 限制 ， 正 式 环境 中 使 用 物理 服 


| 














https://www.docker.io/ 
http://puppetlabs.com/ 
http:/www.cucumber-chef.org/ 
https://github.com/test-kitchen/test-kitchen 


四 鸭 提 日 
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务 器 ”的 现场 不 在 少数 。 在 这 样 的 情况 下 ， 比 较 理想 的 是 尽量 避免 手动 
升级 服务 器 。Kickstart 能 够 实现 物理 服务 器 的 OS 安装 的 自动 化 。 通 过 
组 合 使 用 Kickstart+Cheftserverspec， 能 够 缩短 服务 器 从 投入 到 开始 提供 
服务 的 时 间 (图 6.11 )。 

6.11 ”通过 Kickstart+Chef+serverspec 实现 服务 器 安装 自动 化 的 例子 


产 














服务 器 的 装配 、 配 线 、 接 入 电源 














运行 Kickstart 的 准备 工作 ( PXE 启动 等 ) 


| 安装 OS | 


区 配置 、 磁 盘 大 小 配置 


配置 网 络 


设置 语言 、 时 区 




















Kickstart 











构建 Chef+serverspec 运行 环境 

















checkout Cookbooks 和 serverspec 的 测试 用 例 


A 执行 Che 一 一 一 一 


安装 包 




















checkout 应 用 程序 

















配置 服务 器 应 用 程 语 





Chef + serverspec 














配置 对 应 运行 级 别 的 服务 自动 启动 




















启动 必要 的 服务 
| 执行 serverspec | 
= 在 可 投入 服务 状态 下 启动 服务 器 上 一 



































中 ”相对 于 虚拟 服务 器 来 说 。 





译 者 注 
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6.4.6 “实现 物理 服务 器 投入 运营 为 止 的 所 有 步骤 的 自动 化 


Kickstart 同样 适用 于 虚拟 环境 的 安装 ， 因 此 可 以 在 VirtualBox、 
Xen、KVM 等 上 面 事先 对 这 样 的 流程 进行 验证 。Chef 和 serverspec 的 组 
合 可 以 用 来 进行 测试 ， 并 且 通 过 建立 之 前 叙述 的 构建 服务 器 的 CI 环境 ， 
还 可 以 实现 频繁 地 构建 服务 器 ， 这 样 的 成 功 案例 已 经 有 很 多 了 ， 因 此 可 
以 将 执行 Chef 这 一 步 之 前 的 软件 包 安 装 以 及 和 硬件 相关 的 分 区 设置 等 
交 由 Kickstart 来 人 处理 。 
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6.5 编 配 ( Orchestration ) 


6.5.1 ”发布 作业 的 反面 教材 


这 里 的 编 配 大 致 上 可 以 简单 地 理解 为 发 布 作业 的 自动 化 。 下 面 举 一 
些 发 布 作 业 中 的 反面 教材 ， 如 果 其 中 没有 一 条 和 你 所 在 的 项 目 相符 合 的 
话 ， 可 以 直接 跳 过 本 节 。 

































































@ 手动 进行 发 布 作业 

e@ 发 布 作 业 的 内 容 每 次 都 不 相同 

e@ 发 布 作业 需要 特殊 的 知识 ( 其 他 人 不 知道 如 何 发 布 ) 
@ 不 能 反复 进行 任意 次 数 的 发 布 








什么 是 发 布 ? 发 布 可 以 理解 为 通过 SSH 登录 到 远程 服务 器 ， 将 代 但 
切换 到 最 新 的 分 支 并 进行 更 新 数据 库 等 操作 。 小 型 项 目的 发 布 ， 经 过 几 
个 到 几 十 个 步骤 的 操作 可 能 就 结束 了 。 而 一 定 规模 的 项 目的 发 布 ， 则 需 
要 经 过 数 百 以 至 于 数 千 个 步骤 。 

手动 实施 上 述 工作 不 仅 会 耗费 大 量 的 时 间 ， 对 于 负责 发 布 的 工作 
人 员 的 体力 也 是 极 大 消耗 。 因 此 这 样 的 情况 下 要 反复 地 进行 发 布 是 不 现 
实 的 。 

对 正式 环境 实施 的 发 布 总 是 会 伴随 着 失败 的 风险 。 将 发 布 失 败 的 可 
能 性 降 为 零 是 不 可 能 的 ， 但 有 方法 让 它 接近 于 零 。 那 就 是 推进 发 布 作业 
的 自动 化 。 在 测试 环境 以 及 staging 环境 上 反复 演习 自动 化 的 发 布 并 进 
行 验证 ,在 正式 环境 之 前 发 现 问题 ， 然 后 修改 有 问题 的 内 容 ， 再 反复 地 
对 发 布 进行 演练 ， 这 样 就 能 降低 在 正式 环境 中 发 生 错 误 的 风险 。 
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6.5.2 Capistrano 





6.4 节 中 介绍 了 用 Ruby 编写 的 Chef 和 serverspec， 发 布 作 业 的 自动 
化 方面 也 有 用 Ruby 编写 的 非常 强大 的 工具 Capistrano。 这 款 工具 为 
Ruby on Rails 框架 项 目的 副产品 ， 支 持 Ruby on Rails 应 用 程序 的 部 署 。 
使 用 Ruby 以 外 的 语言 或 框架 编写 的 应 用 程序 的 发 布 同样 可 以 使 用 
Capistrano ， 并 且 已 经 有 了 很 多 这 样 的 实例 。 



































@…… Capistrano 的 系统 构成 
使 用 Capistrano 时 的 系统 构成 如 图 6.12 所 示 。 


图 6.12 ”Capistrano 的 构成 








和 区 
1 role:APi 


















































外 从 Capistrano 执行 服务 器 对 多 个 应 用 程序 服务 器 

同时 执行 命令 
G@) 从 Capistrano 执行 服务 器 对 多 个 DB 服务 器 同时 
执行 命令 


























OD http:/rubyonrails.org/ 
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只 需 在 执行 Capistrano 的 服务 器 上 安装 即 可 使 用 。 也 就 是 说 ， 
Capistrano 采用 的 是 Push 型 的 架构 。 不 需要 在 发 布 对 象 的 服务 器 上 安 
装 代理 等 ， 只 需要 确保 执行 Capistrano 的 服务 器 能 够 通过 SSH 登录 就 
可 以 了 。 

例如 ， 将 多 个 服务 器 按 角色 归纳 为 应 用 程序 服务 器 和 数据 库 (DB ) 
服务 器 ， 对 应 用 程序 服务 器 执行 代码 更 新 的 任务 ， 在 数据 库 服务 器 上 为 
了 修改 数据 库 模式 而 进行 Dump 等 任务 ， 这些 发 布 作业 都 可 以 通过 
Capistrano 一 并 执行 。 

像 这 样 简 单 旦 频繁 的 发 布 作业 ， 在 运 维 中 会 频繁 地 出 现 。 频 度 高 的 
时 候 每 天 、 每 小 时 都 要 进行 。 用 Capistrano 实现 上 述 作 业 的 自动 化 , 无 
论 重 复 多 少 次 都 能 够 毫 无 差 池 地 完成 。 



















































































e…… Capistrano 的 安装 


Capistrano 从 安装 到 初始 化 只 需要 执行 数 条 命令 即 可 ， 因 此 可 谓 是 
使 用 门槛 相当 低 的 工具 。 


$ gem install capistrano 
Sapify 


执行 capify 命 令 会 生成 部 署 配 置 文 件 的 模板 ( 图 6.13 )。 
图 6.13 ”部 署 配 置 文件 模板 的 构成 

















Capfile 
config 


deploy.rb 











本 deploy.rb 





这 里 以 向 webl 和 web2 这 两 个 应 用 程序 服务 器 部 署 文件 为 例 来 讲解 
deploy.rb 的 配置 。 
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role :web, 'webl' , 'web2' 


Easke :depLlovmtask :rolLes® weberde 
upuleacl /us /loosre/ldeplov nt le /me a > sep) 
run "uname -a > /tmp/uname file" 
download "/tmp/uname file", 
"/tmp/uname file.$CAPISTRANO:HOSTS$" 
end 


使 用 upload 向 远程 的 webl、web2 服务 器 部 署 文件 ， 还 能 够 在 
webl1、web2 服务 器 上 执行 通过 run 设置 好 的 命令 。 本 例 中 会 执行 
uname 命 令 ， 并 将 标准 输出 定位 到 /tmp/muname _file。 

最 后 设置 用 download 命令 来 回收 /tmp/uname file。 保 存 回 收文 件 的 
路 径 中 设置 有 $CAPISTRANO: HOSTS 这 样 的 变量 ， 这 是 因为 在 以 多 个 
服务 器 为 对 象 的 情况 下 ， 文 件 名 相同 会 造成 原 有 文件 被 覆盖 ， 因 此 用 远 
程 服务 器 名 来 替换 部 分 文件 名 。 



































@…… Capistrano 的 执行 方法 


Soop dcplow eas 


虽然 需要 事先 确保 作为 执行 对 象 的 webl、web2 服务 器 能 够 通过 
SSH 登录 ， 但 之 后 只 需要 记述 不 满 10 行 的 配置 文件 ， 无 需 反 复 操作 就 
能 确保 执行 相同 的 命令 。 

即便 部 署 对 象 的 台数 增加 ， 也 只 需 在 role 中 添加 对 象 服务 器 ， 并 执 
行 cap 这 1 条 命令 ， 这 样 所 有 的 工作 就 完成 了 。 从 有 1 一 2 台 部 署 的 对 
象 服务 器 时 开始 ， 将 反复 实施 的 作业 做 成 task 并 由 Capistrano 来 实施 ， 
这 样 即便 台数 增加 也 应 该 可 以 轻松 应 对 了 。 























6.5.3 Fabric 





和 Capistrano 相同 ，Fabric 也 是 一 款 通过 SSH 登录 到 多 台 远 程 服务 
右 ， 按 顺序 执行 作业 的 工具 ， 由 Python 编写 。 功 能 上 和 Capistrano 几乎 
完全 相同 ， 比 较 大 的 区 别 在 于 Capistrano 基本 上 是 并 行 执行 处 理 ， 而 
Fabric 则 能 够 简单 地 在 串 行 、 并 行 处 理 间 切换 。 

一 般 认为 为 了 高 效 、 快 速 地 进行 发 布 作业 ， 并 行 处 理会 比较 理想 ， 
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实际 中 因为 要 确保 安全 地 按照 手册 进行 操作 ， 要 以 串 行 方式 处 理 的 情况 
并 不 少见 。 在 6.6 节 中 我 们 将 介绍 无 需 停 止 服务 就 可 以 进行 的 零 停机 时 
间 部 署 (Zero Downtime Deployment )， 如 果 设 定 了 将 两 台 Web 服务 器 
依次 从 网 站 的 负载 均衡 器 上 解除 ， 进 行 更 新 后 再 添加 回去 这 样 的 做 法 ， 
使 用 Fabric 就 能 够 简单 地 实现 。 


























e@……Fabric ( 串 行 执行 ) 的 情况 


@ 从 负载 均衡 器 解除 服务 器 A 
@ 更 新 服务 器 A 
@ 将 服务 器 A 加 回 负载 均衡 器 
@ 从 负载 均衡 器 解除 服务 器 B 
加 更 新 服务 器 B 
@ 将 服务 器 B 加 回 负载 均衡 器 


在 上 述 例子 中 ， 执 行 到 四 一 人 @@ 步 又 时 ， 就 完成 了 一 半 的 发 布 工作 ， 
更 新 完 的 服务 也 将 公开 。 





@…… Capistrano ( 并 行 执 行 ) 的 情况 


@ 从 负载 均衡 器 解除 服务 器 A 
@ 从 负载 均衡 器 解除 服务 器 B 
@ 更 新 服务 器 A 
@ 更 新 服务 器 B 
@ 将 服务 器 A 加 回 负载 均衡 器 
@ 将 服务 器 B 加 回 负载 均衡 器 


Capistrano 在 加 一 四 步 时 服务 停止 ， 和 预期 的 动作 不 相符 。 虽 然 
有 一 些 用 Capistrano 实现 串 行 处 理 的 解决 方案 ， 但 使 用 直接 支持 串 行 处 
理 的 Fabric 更 为 方便 。 





@…… 理解 本 地 服务 器 和 远程 服务 器 操作 上 的 区 别 
首先 来 看 一 下 Fabric 基本 的 记述 例子 。 
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#! /usr/bin/env python 
# =*-= coding: utf-=8 =*= 


from fabric.api import * 


def fabtest() : 
local('mkdir =p /tmp/local test') 
run('mkdir -p /tmp/remote test') 
waenelec /nelocaleest 
local('pwd') 二 lcd/1local 在 本 地 服务 器 上 执行 
with cd('/tmp/remote test'): 
run('pwd') -cd/run 在 远程 服务 器 上 执行 


Fabric 能 够 分 开 记 述 本 地 服务 器 和 远程 服务 器 上 的 操作 。 用 local 记 
述 的 命令 在 运行 Fabric 的 本 地 服务 器 上 执行 ， 用 run 记述 的 命令 在 远程 
服务 器 上 执行 。 在 移动 当前 目录 并 执行 命令 的 情况 下 ， 用 with 语句 将 
lcd 和 local， 以 及 cd 和 run 绑 定 到 一 起 来 记述 

下 面 是 获取 文件 并 部 署 的 例子 


#! /usr/bin/env python 
# =*- Goding: utf-8 -=*- 















































from abrlc a mort > 


def getputtest () : 
get ("/var/log/httpd/access.10g") 
puellueestta em 


Fabric 能 够 从 本 地 服务 器 向 远程 服务 器 发 送 文件 ， 反 之 也 是 可 行 的 。 
上 述 两 个 例子 展示 了 基本 的 Fabric 记述 方法 。 下 面 再 来 看 一 下 有 零 停 
机 时 间 发 布 用 的 fabfile.py， 发 布 作业 自动 化 的 例子 如 下 所 示 。 


#! /usr/bin/env python 
# =*= coding; utf-8 =*= 


lmpone ov os re Stren 


from fabric.api import * 





def getenv (name): < 取得 服务 器 的 环境 变量 
Vionv on lnanee 
return os.environ [name] 


Tet or 兴 


def deploy(): 
changenbalancen orsabten) 
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build update () 
change _ balancer ('enable') 


def change balancezr (mode): 
run('/path/to/change balancer' + mode) < 切换 负载 均衡 器 的 命令 





adelebuaslem uotelyE: 
whoadl /ean e/a 
run('git checkout master && git fetch && git checkout -b %s $s' 和 
(getenv ('RELEASE BRANCH'), getenv('RELEASE TAG'))) 
unm /path/eo/b ul /applicationns tarter cestaney, 





1 重启 应 用 程序 的 命令 











| 














Fabric 可 以 直接 使 用 Python 的 写法 ， 也 可 以 使 用 shell 脚本 的 记述 
方式 ， 因 此 无 论 对 于 运 维 人 员 还 是 开发 人 员 来 说 ，Fabric 都 是 容易 上 手 
的 工具 。 上 述 例 子 中 在 运行 Fabric 的 服务 器 上 将 分 支 名 和 标签 名 分 别 设 
置 给 环境 变量 RELEASE BRANCH 和 RELEASE TAG， 在 这 样 的 状态 
下 执行 Fabric 就 能 切换 到 任意 的 版 本 。 


























@…… Fabric 的 运行 方法 


$ fab -H 服务 器 A, 服务 器 B deploy 


Fabric 可 以 在 fabfile.py 中 自由 地 定义 object。 这 个 例子 中 将 deploy 
作为 object 定义 并 执行 。 这 样 就 如 同 “Fabric( 串 行 执行 ) 的 情况 ”中 
所 记述 的 内 容 一 样 ， 不 需要 停止 服务 就 可 以 进行 发 布 作 业 。 上 述 例子 中 
只 涉及 了 两 台 服务 器 ， 当 服务 器 的 台数 更 多 时 ， 如 果 仍 然 一 台 一 台地 执 
行 的 话 ， 发 布 所 花费 的 时 间 就 会 和 服务 器 台数 成 比例 地 增加 。 为 了 将 发 
布 所 用 的 时 间 控 制 在 一 定 范围 内 ， 可 以 设置 Fabric 为 并 行 执行 ， 并 配置 
同时 执行 的 数量 。 

由 不 少 于 4 台 服 务 器 运行 时 的 命令 如 下 所 示 。 用 - P 指 定 并 行 执 行 ， 
用 -z 来 设置 同时 执行 的 台数 。 


$ fab -P -z 2 服务 器 A, 服务 器 B, 服务器 C, 服务 器 D deploy 
























































@ 服务 器 A， 服 务 器 B 执行 deploy 
四 服务 器 C， 服 务 器 D 执行 deploy 
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发 布 作业 可 以 按照 上 述 顺序 进行 ， 如 果 有 6 台 服 务 器 的 话 ， 可 以 
将 - z 设 置 为 3， 将 发 布 分 为 前 半 部 分 和 后 半 部 分 。 即 使 进一步 增加 服 
务 器 台数 ， 也 可 以 用 和 两 台 服 务 器 时 相同 的 时 间 完 成 发 布 作业 。 通 过 有 
效 运用 Fabric， 就 能 够 很 容易 地 将 我 们 从 手动 发 布 作业 中 解放 出 来 。 






































6.5.4 Jenkins 





Jenkins 作为 CI 工具 来 说 非常 实用 ， 作 为 部 署 的 辅助 工具 来 说 同样 
可 以 加 以 有 效 利 用 。Jenkins 通过 在 远程 服务 器 上 安装 客户 端 代 理 ( slave 
agent )， 可 以 在 远程 服务 器 上 执行 各 类 任务 。 



































@ 主 节点 ( master node ) 和 从 节点 ( slave node ) 的 协作 








Jenkins 客户 端 代理 的 安装 方法 非常 简单 。 确 保 能 够 从 主 节 点 通过 
SSH 登录 到 从 节点 ， 这 样 只 需 在 Jenkins 管理 画面 上 添加 从 节点 ， 主 节 
点 就 会 向 从 节点 部 署 必要 的 文件 ， 并 自动 启动 客户 端 代理 (图 6.14 )。 
客户 端 代理 的 启动 可 以 根据 需要 设置 为 一 直 启 动 、 定 时 启动 ， 或 内 在 执 
行 任务 时 启动 等 。 

































































图 6.14 ”从 主 节点 经 由 从 节点 执行 任务 

埠 Jenkins CE @ 
Jenkins free style #2 

人 @@ 控制 台 输 出 

站 状态 集 

区 变更 记录 Setsy tujikura 

ps oy 汪 tt tl on A wo /samp | b1 





Console Output pa 
> SUCCESS 
闻 View as plain text 





区 编辑 编译 信息 

人 删除 本 次 生成 

嘻 前 一 次 构建 

孔 部 动 我 们 本 地 化 当前 页 生成 页面: 2015-1-4 20:44:26 ”REST API Jankins ver 1.590 


这 里 将 对 象 服务 器 作为 节点 、 将 部 署 相 关 的 task 作为 任务 进行 管 
理 ， 通 过 联系 各 个 事物 ， 来 构建 自动 化 发 布 的 环境 。 和 编 配 工具 


] 了 J 
































中 Jenkins 的 安装 方法 请 参照 5.4 节 。 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 








版 权 











238 | 第 6 章 部 署 的 自动 化 ( 持续 交付 ) 






































Capistrano/Fabric 相 比 ，Jenkins 的 优势 在 于 具备 控制 台 输 出 和 用 户 管理 
功能 。 

无 论 是 为 了 能 在 Web 的 管理 画面 上 看 到 谁 、 何 时 、 执 行 了 什么 内 容 
这 样 的 记录 ， 还 是 从 留 下 跟踪 信息 的 观点 出 发 ，Jenkins 可 以 自动 实现 上 
述 功 能 。 通 过 添加 Active Directory plugin" 这 款 插件 ，Jenkins 能 够 和 
Active Directory 进行 协作 。 并 且 通 过 添加 Role Strategy Plugin 插件 ， 
Jenkins 可 以 以 任务 为 单位 进行 用 户 权限 管理 。 因 此 ， 即 便 是 需要 严格 进 
行 用 户 管理 的 企业 ， 也 可 以 放心 使 用 。 

通过 利用 Jenkins 的 参数 化 构建 ( build ) 这 个 功能 ， 可 以 在 每 次 执 
行 任务 时 传递 shell 变量 ， 以 全 对 任务 浊 行 省 和 

下 面 ， 我 们 以 从 远程 服务 器 上 通过 scp 命 令 发 送 文件 为 例 ， 对 从 节 
点 的 添加 、 任 务 的 设置 、 执 行 等 一 系列 流程 进行 讲解 。 



























































@…… 从 节点 的 添加 


顺利 启动 Jenkins 后 ， 通 过 浏览 絮 访 问 http://${remote_ 
host} :8080， 能够 看 到 Jenkins 管理 画面 的 初始 状态 。 该 状态 允许 文 
件 访问 ， 因 此 正式 使 用 的 情况 下 ， 建 议 通过 添加 用 户 或 防火 墙 等 对 IP 
进行 适当 的 限制 。 

添加 从 节点 时 ， 按 照 “ 系 统管 理 ” 一 “管理 节点 ”一 “新 建 节点 ” 
这 样 的 流程 对 节点 进行 设置 。 必 须 设置 的 项 目 有 of executors (同时 
build 数量 ) 和 远程 工作 目录 、 启 动 方法 (图 6.15 )。 








Ll 























D https:/Wwikijenkins-ci.org/display/JENKINS/Active+Directory+plugin 
©® https://wikijenkins-ci.org/display/JENKINS/Rolet+Strategy+Plugin 
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图 6.15 ”节点 的 添加 
才 Jenkins 





会 返回 名 字 slave-node1 © 
光 系统 管理 描 太 © 
三 新 建 节点 
# of executors [3 3 @ 
兴 本 至 
远程 工作 目录 | Naribjienkins © 
构建 队列 Ss 
标签 © 
队列 中 没有 构建 任务 
用 法 j 
尽 可 能 的 使 用 这 个 节点 -Je 
1 空闲 启动 方法 Launch slave agents on Unix machines via SSH J © 
2 空闲 
Host 127.0.0.1 
Crodentias | ov -| | aa © 
高 级 … 
Availabilty | keep this slave on-line as much as possible 到 © 
Node Properties 
Environment variables 
Tool Locations 























由 远程 工作 目录 决定 部 署 客户 端 代理 的 路 径 ， 如 果 该 目录 下 还 没有 
部 署 客户 端 代 理 ，Jenkins 会 自动 从 主 节点 向 对 应 的 路 径 进 行 部 署 。 在 启 
动 方法 中 配置 启动 客户 端 代理 所 需要 的 路 径 。 

UNIX 系统 选择 Launch slave agents on Unix machines via SSH， 
Windows 机 需 可 以 选择 Let Jenkins control this Windows slave as a 
Windows service。 其 他 启动 客户 端 代理 的 方法 还 有 JNLP ( Java Network 
Launching Protocol )， 该 方法 适用 于 主 节 点 在 防火 墙 外 ， 其 他 的 从 节点 
在 防火 墙 内 等 存在 网 络 限制 的 情况 。 

为 了 通过 SSH 启动 客户 端 代 理 ， 需 要 配置 认证 信息 ， 这 里 可 以 设置 
ID/PASS 或 密 钥 (图 6.16 )。 
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6.16 ”认证 信息 的 管理 





筷 Jenkins 
雷 新 于 条 Manage Credentials 
用 户 
外 These credentials can be used by Jenkins and by jobs running in Jenkins. 
民 人 历史 
Credentials not bound to a domain 
天 系统 管理 Credentials 
绚 Credentials Username with password 
Soope Global 导 © 
构建 队列 = Username pe © 
队列 中 没有 构建 任务 
net i meee 加 
扳 建 执行 状态 = 
Descriptior © 
1 空闲 
医 司 
Add Credentials ~ 
eame wn pasword 
(sh Unane winpvas key | 
EN 














待 节点 的 配置 完成 并 通过 认证 ， 远 程 服务 器 上 会 启动 名 为 slave.jar 
的 进程 ， 作 为 主 节 点 的 管理 对 象 由 主 节 点 控制 。 如 果 添 加 从 节点 出 错 ， 
有 可 能 是 因为 认证 信息 没有 正确 设置 , 或 者 bashrc 中 记载 了 多 余 的 命令 
而 造成 了 slave.jar 启动 失败 。 














@…… 任务 的 添加 


添加 完 从 节点 后 ， 接 着 添加 在 从 节点 上 执行 的 任务 。 可 以 从 Jenkins 
首页 的 “新 建 ” 开 始 添 加 。 选 择 “ 构 建 一 个 自由 风格 的 软件 项 目 ”。 
Jenkins 是 作为 CI 工具 开发 的 ， 所 以 有 构建 和 代码 管理 相关 的 配置 ， 作 
为 编 配 工具 使 用 时 可 以 直接 跳 过 这 部 分 配置 。 

在 Restrict where this project can be run 设置 刚才 添加 的 节点 ， 点 击 
“构建 ”下 的 “增加 构建 步骤 ”， 选 择 “Execute shell”， 这 样 就 能 在 远程 
服务 器 上 执行 任意 的 命令 了 。 作 为 执行 命令 时 传递 变量 的 方法 ， 可 以 选 
中 “参数 化 构建 过 程 ”， 添 加 文本 、 字 符 串 、 单 选 框 等 输入 栏 。 可 以 设 
置 多 个 参数 ,“ 名 字 ” 一 栏 中 输入 的 文字 能 够 直接 作为 环境 变量 传递 给 脚 
本 (图 6.17)。 
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图 6.17 ”任务 的 添加 











Jenkins sample-job1 配置 
项 目 名 称 sample-job1 
指 述 
甘谷 dk 录 
全 工人 空间 
内 Bund with Parameters 
Escaped HTMU] 预 玫 nr 
回 丢弃 旧 的 构建 © 
回 Backlog 
Build History 构建 历史 一 GitHub project 和 
国 8SS 全 部 国 RSS 和 失败。 团 参数 化 构建 过 各 © 
String Parameter © 
名 字 | FILENAME © 
时 认 什 © 
措 汪 [从 远 程 服务 器 上 获取 文件 
© 


[Escaped HTML] 预 融 





添加 各 数 。 ~ 
回 关闭 构建 (重新 开启 构建 前 不 允许 进行 新 的 构建 ) © 
回 在 必要 的 时 人 并 发 构建 © 
加 Restrict where this project can be mn © 
Label Expression | slave.nodel 
Slaves in label: 1 
高 级 项 目 选项 
源码 管理 
® None 
) CVs 

CVS Projectset 
© Git 
© Subversion 
构建 独 发 器 
@ Build after other projects are built © 
回 Build periodically © 
回 Build when a change is pushed to GitHub 
回 GitHub Pull Request Builder 
加 Pol scM © 
构建 环境 
回 SSH Agent 
构建 

Execute shell © 

Command | scp $ {FILRNAME) /tmp/§ {NODE_NAME)_$ {FILENAME#Hs/ 

See the list of available envieonment variables 

增加 构建 步骤。 ~ 

构建 后 操作 


增加 构建 后 操作 步骤 。 ~ 


| 





015-1.6 15:06:51 -REST AP| ‘Jenkins ver 1.590 
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这 里 定义 名 为 FILENAME 的 字符 串 变 量 ，shell 脚本 中 的 调用 方式 
如 下 。 
scp ${FILENAME} /tmp/${NODE NAME} $ {FILENAME##*/} 
除了 上 述 参 数 之 外 ，Jenkins 的 任务 中 还 可 以 使 用 名 为 NODE_ 
NAME 的 变量 




















@…… 任务 的 执行 


任务 添加 完成 后 就 是 执行 了 。 点 击 新 建 任务 中 的 Build with 
Parameters， 会 出 现任 务 中 配置 参数 的 输入 画面 ， 输 入 远程 服务 器 上 部 























署 文件 的 路 径 (图 6.18 )。 点 击 开始 构建 ， 就 可 以 从 远程 服务 器 上 获取 
任意 文件 。 

6.18 ”任务 的 执行 

和 攻 Jenkins 





Jenkins sample-job1 
会 返回 面板 Project sample-job1 
筷 状态 
人 需要 如 下 参数 用 于 构建 项 目 : 
时 修改 记录 
Ea FILENAME| Amplconfgxml 
包 工作 空间 从 运程 服务 器 上 获取 文件 
例 Build with Parameters 
© 删除 Project 
六 配置 
Build History 构建 历史 一 
国 RSS 全 部 国 RSS 失败 








任务 执行 的 记录 会 留 在 “构建 历史 ”中 。 蓝 色 的 图 标 表示 成 功 ， 红 
色 的 图 标 表示 失败 ， 一 目 了 然 。 如 果 失 败 的 话 ， 点 击 “ 构 建 历史 ”的 链 
接 ， 通 过 确认 “控制 台 输 出 ”的 shell 标准 输出 ， 就 可 以 确认 失败 的 具 
体内 容 。 

这 个 例子 中 是 通过 点 击 构建 按键 来 执行 任务 的 ， 其 他 的 任务 执行 时 
间 还 可 以 选择 Build after other projects are built ( 在 其 他 项 目的 构建 后 开 
始 构建 ) 或 Build periodically ( 定时 构建 )。Build periodically 能 够 以 
Cron 的 形式 安排 任务 执行 。 因 此 应 用 本 例 中 所 列举 的 scp 任意 文件 的 内 
容 ，Build periodically 能 够 实现 从 多 个 从 节点 上 定时 收集 各 类 日 志 这 一 
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作业 的 自动 化 。 
Jenkins 能 及 时 掌握 哪个 从 节点 的 日 志 收 集 处 理 失 败 等 信息 ， 对 失败 
的 处 理 还 可 以 配置 警告 ， 因 此 可 以 作为 管理 工具 加 以 有 效 利 用 。 























6.5.5 ”最 佳 实 践 





@…… 结合 Jenkins 和 Fabric 


























至 此 我 们 介绍 了 几 款 编 配 相关 的 工具 。 并 不 是 说 只 要 选用 其 中 的 
个 就 可 以 了 ， 只 有 组 合 使 用 上 述 工具 ， 才 能 实现 先进 的 自动 化 环境 构建 。 
笔者 所 实践 的 自动 化 部 署 环境 中 ， 用 Jenkins 管理 所 有 的 任务 ， 通 过 
SSH 登录 远程 主机 ， 执 行 shell 的 部 分 则 使 用 Fabric 来 实施 ( 图 6.19 )。 











图 6.19 Jenkins 和 Fabric 的 组 合 





Jenkins 主 节 点 Jenkins 从 节点 
、: ( Fabric 的 运行 服务 器 ) 



















通过 Fabric 对 远程 
服务 器 执行 shell 


国 : 二 B 国 。 Cc 国 : D 


这 个 结构 的 优点 在 于 ， 通 过 Jenkins 的 从 节点 执行 Fabric， 能 够 将 
Fabric 的 执行 结果 作为 Jenkins 的 控制 台 日 志保 存 下 来 。Fabric 添加 远程 
主机 非常 容易 ， 并 且 能 够 作为 代码 进行 管理 ， 因 此 在 版 本 管理 的 基础 上 
可 以 对 手头 的 环境 进行 验证 ， 或 者 对 各 类 环境 进行 操作 。 

通过 组 合 使 用 工具 ， 就 能 够 取长补短 ， 提 高 工作 效率 。 
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6.5.6 ”考虑 安全 问题 








推进 发 布 的 自动 化 需要 考虑 用 root 账户 登录 SSH 并 执行 命令 ,或 
者 以 有 权 执 行 sudo 的 用 户 进 行 登录 。 但 从 安全 方面 来 说 ， 允 许 root 登 
录 是 非常 危险 的 ， 因 此 很 多 服务 器 将 sshd_config 中 的 PermitRootLogin 
设置 为 no。 

在 这 种 情况 下 ， 可 以 设置 为 只 有 从 运行 Capistrano 或 Fabric 的 服务 
器 发 出 的 登录 请 求 才 允许 PermitRootLogin， 禁 止 除 此 之 外 的 客户 端的 
root 登录 。 
通过 设置 为 具有 特定 的 用 户 〈 服 务 器 管理 员 ) 才能 登录 到 运行 
Capistrano 或 Fabric 的 服务 器 ， 并 采用 公 铀 验证 的 方式 ， 就 能 在 确保 安 
全 性 的 同时 构建 自由 度 较 高 的 发 布 自动 化 环境 。 具体 地 说 就 是 ， 对 部 署 
目标 服务 器 的 /etc/ssh/sshd_config 进行 如 下 配置 。 




































































RSAAuthentication yes 
PasswordAuthentication no 
PermitRootLogin no 





Match Address 192.168.1.1/32 二 从 OpenSSH4 .4 开始 可 以 使 用 Match 命 令 
PermitRootLogin without-password 





1 通过 设置 without -password， 人 允许 密码 认证 以 外 的 登录 方式 

















sshd 中 可 以 用 Match 命令 对 条 件 分 支 进行 配置 ， 如 果 是 符合 条 件 的 
IP 地 址 或 用 户 发 出 的 SSH 连接 请 求 的 话 ， 可 以 按照 配置 的 内 容 进行 控制 。 
本 例 中 ， 假 定 运行 Capistrano 或 Fabric 服务 器 的 卫 地 址 为 192.168.1.1， 则 
仅 人 允许 上 述 服务 器 对 root 账户 发 起 RSA 认证 的 SSH 连接 请 求 。 从 安全 
性 方面 来 说 ， 需 要 在 兼顾 各 方面 的 基础 上 进行 有 效 的 设计 。 
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-一 专栏 ”手动 部 署 的 例子 


至 此 我 们 介绍 了 几 款 部 署 的 自动 化 工具 ， 但 实际 运用 中 仍然 
不 得 不 手动 作业 的 状况 发 生 。 










































































国 无 法 实现 自动 化 ， 不 得 不 手动 作业 的 情况 
需要 手动 作业 的 案例 有 下 面 这 些 。 

















@ 第 一 次 构建 自动 化 环境 时 

@ 获取 修复 故障 用 的 特殊 日 志 

全 紧急 地 重启 服务 

@ 预料 之 外 的 情况 导致 自动 部 署 停止 时 ， 为 了 下 次 部 署 正常 运 
行 而 进行 的 修复 工作 








关于 @@ ~ 合 ， 如 果 今 后 可 能 反复 发 生 的 话 ， 为 了 任何 时 候 都 能 
够 处 理 ， 建 议 为 它们 配置 自动 化 。 
@ 的 情况 下 ， 需 要 注意 的 是 这 里 并 不 推荐 在 部 署 失 败 时 强行 
动 对 服务 器 进行 调整 。 为 了 通过 部 署 而 强行 修改 配置 的 话 ， 广 
致 验证 环境 和 正式 环境 产生 差异 ， 那 么 下 次 部 署 时 就 很 有 可 能 
失败 。 

部 署 脚本 的 内 容 出 错 的 话 ， 应 该 修正 错误 并 再 度 实施 部 署 ， 除 
此 之 外 的 方法 这 里 都 不 认可 。@ 中 的 修复 工作 是 指 那 些 在 并 非 由 于 
部 署 脚本 的 内 容 而 造成 部 署 停止 的 情况 下 进行 的 修复 工作 ， 例 如 由 
于 磁盘 空间 不 足 而 造成 部 署 失 败 时 ， 为 了 确保 剩余 空间 而 删除 一 些 
不 需要 的 文件 等 。 

我 们 不 可 能 提前 预测 到 实际 运用 中 的 各 种 情况 并 做 好 准备 。1 台 
服务 器 的 话 还 可 以 通过 SSH 登录 进行 操作 ， 而 要 对 多 人 台 服 务 器 实施 
作业 的 话 ， 就 非常 考验 耐心 和 集中 力 了 。 

针对 这 些 意外 产生 的 手动 作业 ， 也 应 该 尽 可 能 地 借助 工具 ， 考 
虑 是 否 可 以 通过 利用 工具 ， 实 现 无 论 几 台 服 务 器 都 只 需要 一 次 输入 
就 能 完成 作业 。 
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国手 动 部 署 的 实用 工具 
表 6.a 中 列举 了 手动 作业 时 的 一 些 实用 工具 。 
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表 6.a ”手动 部 署 的 实用 工具 


RLogin Windows 上 运行 的 名 为 RLogin 的 终端 能 够 向 所 有 打 
的 连接 同时 发 送 按键 输入 的 操作 ， 这 样 就 能 对 所 有 
登录 状态 下 的 服务 器 同时 实施 相同 的 操作 
Tera Term 借助 常规 的 终端 软件 Tera Term “的 广播 命令 功能 ， 可 
以 向 多 个 终端 同时 发 送 命令 。 感 觉 只 操作 了 1 台 服 务 器 ， 
但 实际 上 能 够 同时 对 10 台 、 甚 至 100 台 服 务 器 进行 操 
作 ， 还 可 以 减少 操作 失误 的 可 能 性 。 需 要 注意 的 是 ， 原 
则 上 同时 向 多 个 目标 发 送 键盘 的 输入 ， 服 务 器 状态 不 一 
致 的 情况 下 可 能 会 返回 不 一 样 的 结果 。 例 如 执行 cd/usr/ 
local/tmp/ 命令 后 再 执行 touch test 的 情况 下 ，1 台 特 定 
机 器 上 的 /usr/localtmp/ 目录 损坏 时 ，test 文件 就 会 被 
生成 在 登录 时 的 目录 下 。 因 此 ， 在 每 一 步 操 作 之 后 ， 应 
该 尽 可 能 地 确认 下 所 有 的 终端 ， 或 者 设法 通过 操作 来 吸 
收 这 种 环境 上 的 差异 
ClusterSSH/Par- | Linux 或 Mac OS 等 UNIX 系统 环境 上 有 ClusterSSH/ 
allelssh/Clusterlt | Parallelssh/Clusterlt” 等 的 OSS， 能 够 在 多 台 服 务 器 上 
同时 执行 命令 
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QD http://nanno.dip.jp/softlib/man/rlogin/ 并 不 是 使 用 513TCP 端口 的 工具 。 
©® http:/www.vector.co.jp/soft/win95/net/se276622.html 
@) http://sourceforge.jp/magazine/08/11/06/0025200 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 











相关 的 问题 | 247 


(ey) 
加 
ut 
[sl 














6.6 考虑 运用 相关 的 问题 


结合 使 用 之 前 介绍 过 的 部 署 自动 化 相关 的 各 类 工具 就 能 够 构建 部 署 
流水 线 。 部 署 流水 线 建 成 并 进入 到 维护 的 循环 阶段 后 ， 就 可 以 在 理想 的 
时 间 ， 安 全 地 向 正式 环境 部 署 新 的 代码 ， 这 样 就 可 以 频繁 地 对 正式 环境 
进行 部 署 了 。 这 时 需要 考虑 新 的 问题 ， 就 是 该 如 何 处 理 向 正式 环境 部 署 
过 程 中 发 生 的 服务 中 断 ， 以 及 由 版 本 更 新 所 引发 的 问题 。 

不 解决 这 些 问题 就 无 法 对 正式 环境 进行 频繁 的 部 署 ， 因 此 下 面 将 介 
绍 部 署 时 无 需 中 断 服务 的 机 制 ， 以 及 部 署 后 发 生 的 问题 的 应 对 方法 。 


















































6.6.1 不 中 断 服务 的 部 署 方法 


多 数 Web 应 用 程序 在 代码 被 更 新 后 都 需要 重启 Web 服务 。 在 请 求 
处 理 过 程 中 重启 ， 不 仅 会 造成 该 请 求 失败 ， 万 一 启动 失败 的 话 还 有 可 能 
造成 服务 中 断 。 既 然 部 署 作业 有 可 能 会 造成 服务 中 断 ， 那 么 在 工作 日 白 
天 进行 部 署 的 话 就 不 会 被 允许 吧 。 无 论 部 署 作业 的 自动 化 程度 有 多 高 ， 
这 样 也 无 法 实现 频繁 的 部 署 。 因 此 这 里 首先 介绍 不 会 因 部 署 造成 服务 中 
断 的 机 制 ， 即 零 中 断 时 间 部 署 的 相关 内 容 。 











6.6.2 ” 蓝 绿 部 署 ( blue-green deployment ) 


首先 我 们 来 看 一 下 零 中 断 时 间 部 署 方 法 之 一 的 蓝 绿 部 署 ( 图 6.20 )。 
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6.20 ，” 蓝 绿 部 署 











发 布 过 程 中 测试 账户 被 划分 到 版 本 应 用 程序 v121 
更 新 后 的 蓝 环境 ， 一 般 用 户 被 划分 ie 
到 现行 版 本 的 绿 环境 0 















































































































































和 
荆 
测试 账 生 
则 试 几 测试 由 
三 重 三 
rp 会 有 
负载 均衡 器 国 
般 用 户 绿 环境 
应 用 程序 v120 





























图 6.20 中 设置 有 负载 均衡 器 ， 后 端 有 两 台 应 用 程序 服务 器 分 担负 
载 ， 下 面 我 们 就 以 这 样 的 构造 为 例 来 讲解 零 中 断 时 间 部 署 。 应 用 程序 服 
务 右 分 别 分 成 蓝 环境 ( blue.example.com ) 和 绿 环 境 ( green.example.com )， 
负载 均衡 需 采 用 Apache 的 mod_proxy_balancer 模块 和 mod rewrite 模 
块 的 组 合 ， 配 置 示例 如 下 。 

# 模 块 的 加 载 以 及 mod_rewrite 的 有 效 化 


LoadModule proxy module modules/mod proxy.so 
































LoadModule proxy balancer module modules/mod proxy balancer.so 
LoadModule rewrite module modules/mod rewrite.so 

RewriteEngine On 
RewriteLogLevel 1 
RewriteLog logs/rewrite.1log 























# 负 载 均衡 器 的 管理 画面 用 的 URL /balancer-manager 的 配置 
<Location /balancer-manager> 














SetHandler balancer-manager 

Order deny,allow 

Deny from all 

Allow from 192.168.0.0/16 
</Location> 











# 测 试 账户 用 的 负载 均衡 组 

<Proxy balancer://test.example.com> 
BalancerMember http://blue.example.com:8080 loadfactor=50 
BalancerMember http://green.example.com:8080 loadfactor=50 














</Proxy> 
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# 一 般 用 户 用 的 负载 均衡 组 
<Proxy balancer://prod.example.com> 
BalancerMember http://blue.example.com:8080 loadfactor=50 
BalancerMember http://green.example.com:8080 loadfactor=50 
</Proxy> 


# 测 试 账户 的 配置 

# 测 试 账户 的 TP 地址 

RewriteCond %{REMOTE ADDR} “10.8.15.1$ 

RewriteCond %{REQUEST FILENAME} ! /balancer-managez 
RewriteRule “/(.*) balancer://test.example.com/$1 [P] 























# 一 般 用 户 的 配置 
RewriteCond %{REQUEST FILENAME} !’/balancer-manager 
RewriteRule “/(.*) balancer://prod.example.com/$1 [P] 


在 浏览 器 中 输入 http://${remote host})/balancer-manager,，, 
访问 采用 上 述 配置 的 负载 均衡 器 ， 会 显示 负载 均衡 器 的 管理 画面 (图 
6.21 )。 











图 6.21 ”负载 均衡 器 的 管理 画面 


Load Balancer Manager for loadbalancer.example.com 





Server Version: Apache/22.15 (Unbd DAV/2 
Server Built: Feb 13 2012 22:31:42 





LoadBalancer Status for balancer://test.example.com 


StickySession Timeout FailoverAttempts Method 





a 0 1 byrequests 

Worker URL Route RouteRedir Factor Set Status Elected To From 
pi 50 0 Ok 0 0 0 

http://greenexample com.3080 50 0 Ok 0 0 0 


LoadBalancer Status for balancer://prod.example.com 


StickySession Timeout FailoverAttempts Method 

各 0 1 byrequests 

Worker URL Route RouteRedir Factor Set Status Elected To From 
50 0 Ok 1 0 0 

0 50 0 Ok 1 0 0 












http/greenexamplecor 





MApachper22 阿 (CentOS) Server at joadbalancer.exampie.com Port 80 











如 图 6.21 所 示 ， 可 以 对 发 送 至 测试 账户 的 负载 均衡 组 和 一 般 用 户 的 
负载 均衡 组 的 蓝 绿 环境 的 请 求 进行 配置 。 在 上 述 环境 下 ， 实 现 蓝 绿 部 署 
的 步骤 如 下 所 示 。 
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@ 将 balancer://test.example.com 的 green.example.com 设置 为 
Disable 

@ 将 balancer:/prod.example.com 的 blue.example.com 设置 为 
Disable 

@ 对 blue.example.com 实施 自动 部 署 ， 更 新 应 用 程序 

@ 从 IP 地 址 为 10.8.15.1 的 机 器 执行 测试 ( 被 划分 到 测试 用 的 负 
载 均衡 组 )， 到 下 一 个 步骤 为 止 的 时 间 段 中 ， 一 般 用 户 的 请 求 被 
分 配 到 prod.example.com， 服 务 持续 提供 

加 通过 测试 后 ， 将 balancer://test.example.com 的 green.example.com 
设置 为 Enable 

@ 将 balancer://test.example.com 的 blue.example.com 设置 为 Disable 

@ 将 balancer/prod.example.com 的 blue.example.com 设置 为 Enable 

@ 将 balancer://prod.example.com 的 green.example.com 设置 为 
Disable。 这 时 一 般 用 户 可 以 开始 使 用 新 版 本 的 服务 

四 对 green.example.com 实施 自动 部 署 ， 更 新 应 用 程序 

@ 从 IP 地 址 为 10.8.15.1 的 机 器 上 执行 测试 

人 @ 通过 测试 后 所 有 的 负载 均衡 组 都 设置 为 Enable， 部 署 作业 结束 


以 这 样 的 流程 进行 部 署 ， 应 用 程序 更 新 过 程 中 就 无 需 停 止 服务 。 
mod proxy_ balancer 的 各 个 负载 均衡 组 的 Disable 和 Enable 的 切换 可 以 
通过 HTTP 来 操作 ， 因 此 可 以 使 用 Mechanize 这 样 的 程序 来 控制 。 蓝 
绿 部 署 时 需要 注意 的 是 ， 通 常 不 进行 发 布 时 ， 为 了 不 浪费 资源 配置 ， 
会 将 一 般 用 户 分 别 均 分 到 蓝 环境 和 绿 环境 ， 而 发 布 作业 时 由 于 需要 降 
级 运行 ”, 因此 要 选择 用 户 较 少 的 时 间 段 , 或 者 平时 保留 一 定 接 入 能 力 的 

入 
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6.6.3 云 (cloud ) 时 代 的 蓝 绿 部 署 


AWS 等 IaaS ( Infrastructure as a Service ) 能 够 瞬间 添加 服务 器 资 





中 降级 运行 是 指 在 部 分 停止 系统 的 功能 或 性 能 的 状态 下 维持 系统 运行 。 





译 者 注 
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源 ， 这 个 特长 同样 能 够 运用 到 零 中 断 时 间 发 布 上 。 以 刚才 的 蓝 绿 部 署 的 
应 用 为 例 ， 可 以 采用 这 样 的 方法 : 平时 只 运行 绿 环境 这 一 套 系统 ， 仅 在 
发 布 时 利用 Iaas 功能 制作 绿 环境 的 镜像 ， 再 从 镜像 启动 蓝 环境 进行 发 布 
作业 。 只 要 能 实现 上 述 模式 的 发 布 ， 就 基本 上 可 以 克服 一 般 的 蓝 绿 部 署 
的 弱点 了 。 

发 布 时 无 需 降 级 运行 ， 平 时 也 不 需要 准备 双 份 的 服务 器 资源 ， 就 能 
够 随时 实施 发 布 。 缺 点 在 于 需要 增加 镜像 的 制作 、 服 务 器 的 启动 ， 以 及 
发 布 结束 后 删除 蓝 环境 这 一 系列 的 工作 。 发 布 作业 变 得 复杂 ， 失 败 的 风 
险 也 随 之 上 升 。 

在 服务 器 启动 时 采取 下 列 对 策 能 有 效 地 降低 风险 ， 可 以 在 对 比 这 些 
对 策 的 准备 工作 所 需 的 开销 以 及 所 带 来 的 收益 的 基础 上 再 进行 探讨 。 















































@ 服务 器 启动 后 用 serverspec 实施 自动 测试 
@( AWS 的 情况 下 ) 服务 器 的 启动 操作 用 awscli 等 工具 来 实现 自动 化 
@ 平时 在 staging 环境 上 对 一 系列 部 署 的 自动 化 进行 测试 


6.6.4” 回 深 (rollback ) 相关 问题 的 考察 


@…… 随时 准备 好 退路 


无 论 事 前 进行 多 么 充分 的 测试 ， 对 正式 环境 实施 发 布 总 是 隐藏 着 发 
生意 外 的 危险 。 比 如 ,用户 使 用 了 超出 QA (品质 保证 ) 部 门 预测 的 服 
务 等 ， 进 而 造成 正式 环境 发 生 故 障 。 

也 就 是 说 ， 要 时 常 意识 到 发 布 时 有 可 能 将 bug 也 一 同 发 布 出 去 。 需 
要 根据 bug 的 严重 程度 ， 判 断 是 进行 回 滚 还 是 在 下 次 发 布 时 修正 。 因 此 
在 进行 发 布 之 前 ， 要 准备 好 随时 回 滚 的 机 制 。 反 过 来 说 就 是 ， 不 应 该 实 
施 无 法 回 滚 的 发 布 作业 。 



































e@…… 数据 库 模 式 的 版 本 管理 
代码 的 回 深 只 需要 回 退 到 升级 前 运行 的 版 本 ,多数 情况 下 这 样 就 可 
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以 了 。 一 般 的 Web 应 用 程序 将 持久 性 数据 保存 在 RDBMS 中 。 如 果 需 要 
回 滚 数据 库 的 话 ， 可 以 使 用 数据 库 迁移 工具 ”。 

















e@…… 回 滚 的 验证 


假设 有 下 面 这 样 的 作业 流程 ， 我 们 需要 验证 在 哪个 阶段 失败 ， 以 及 
如 何 回 滚 。 


@ 显示 维护 画面 
名 停止 应 用 程序 
@@ 更 新 源 代码 

@ 更 新 配置 文件 
加 更 新 数据 库 模式 
@ 启动 应 用 程序 
@ 实施 冒 烟 测试 
@ 实施 性 能 测试 
@@ 解除 维护 画面 
@@ 报告 发 布 结束 





最 理想 的 情况 是 能 够 为 所 有 阶段 的 失败 提供 自动 化 的 回 深 机 制 , 但 
这 样 会 耗费 高 昂 的 成 本 。 不 过 至 少 也 一 定 要 准备 好 确实 可 行 的 回 深 机 制 ， 
即使 是 手动 的 也 行 。 手 动 回 深 的 话 ，Rlogin 等 辅助 工具 是 非常 有 用 的 。 

下 面 我 们 来 考虑 一 下 在 两 个 比较 主要 的 回 滚 点 发 生 问 题 时 的 处 理 
流程 。 














A 


























@…… 只 更 新 代码 的 发 布 时 的 回 滚 


例如 在 步骤 全 发 布 作业 中 断 ， 无 法 继续 进行 发 布 的 情况 下 ， 回 滚 
的 步骤 如 下 。 





@ 将 更 新 了 的 代码 回 退 到 以 前 的 版 本 
@@ 启动 应 用 程序 





@， 这 款 工 具 在 第 3 章 中 有 详细 介绍 。 
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O) 
O) 
ut 
[a 














@ 实施 冒 烟 测试 
@ 解除 维护 画面 
@ 报告 发 布 延 期 





这 是 最 简单 的 流程 ， 只 需 退 回 到 之 前 的 版 本 就 可 以 了 。 但 是 回 滚 结 
束 后 必须 用 serverspec 等 对 服务 器 进行 测试 ,确认 程 序 是 否 正 常 回 退 ， 
并 实施 冒 烟 测试 ， 确 认 应 用 程序 是 否 正常 运行 。 





























@…… 数据 库 模 式 更 新 时 的 回 滚 


到 冒 烟 测 试 为 止 都 正常 运行 ， 在 步 又 人 @ 时 发 现 比 起 发 布 前 ， 一 部 
分 功能 的 性 能 慢 了 10 倍 ， 这 样 的 情况 下 该 怎么 做 呢 ? 当然 ， 发 布 前 的 
各 种 测试 必须 对 这 类 问题 进行 覆盖 ,但 用 测试 用 例 覆 盖 所 有 问题 是 不 可 
能 的 。 长 期 运营 的 系统 会 经 常 遇 到 这 类 问题 。 

例如 ， 特 定 用 户 的 特定 项 目的 数据 量 极端 大 的 情况 下 ， 或 者 是 性 质 
或 倾向 不 确定 的 多 用 户 系统 中 ， 随 着 各 类 使 用 模式 的 增加 ， 性 能 有 时 会 
发 生 退 化 。 发 生性 能 相关 问题 的 情况 下 必须 立即 进行 回 滚 。 
如 果 没 有 上 述 步 又 @ 的 话 ， 如 上 所 述 ， 只 需 回 深 代 码 就 能 解决 问 
题 。 即 便 是 能 够 立即 修复 的 问题 也 请 先行 回 深 ， 经 过 通常 的 流程 后 再 次 
进行 发 布 。 
由 步 又 加 造成 性 能 相关 的 问题 时 ， 以 下 情况 可 以 通过 回 退 到 原来 
的 状态 ， 也 就 是 说 通过 回 滚 数据 库 模 式 来 解决 。 










































































@ 系统 允许 该 数据 丢失 ( 为 了 收集 针对 新 功能 的 日 志 而 存储 的 数据 等 ) 
@ 更 新 的 内 容 是 数据 迁移 或 规格 化 、 非 规格 化 等 不 会 造成 数据 丢失 
的 作业 














但 是 也 存在 下 面 这 些 无 论 如 何 都 无 法 回 滚 的 情况 。 





@ 系统 不 允许 该 数据 丢失 
@ 回 滚 时 有 可 能 产生 数据 一 致 性 问题 





这 样 的 情况 下 无 法 回 滚 数据 库 模式 。 因 此 要 预先 确认 更 新 的 数据 库 
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模式 属于 上 述 哪 种 形式 。 

可 以 回 滚 的 模式 没有 什么 需要 特别 担心 的 ， 只 要 使 用 迁移 工具 实施 
预先 测试 过 的 回 滚 操 作 ， 修 正 bug 后 重新 进行 发 布 即 可 。 

无 法 回 滚 的 模式 虽说 并 非 完全 没有 规避 的 方法 ， 但 为 此 需要 建立 大 
规模 的 机 制 ， 非 常 麻 烦 。 对 于 这 样 的 高 风险 作业 ， 建 议 设置 停机 维护 时 
间 ， 在 对 用 户 影响 较 小 的 日 期 、 时 间 实 施 发 布 。 具 体 做 法 这 里 就 不 再 详 
述 了 。 万 一 发 生 问题 的 情况 下 ， 将 风险 最 小 化 ， 并 尽早 解决 问题 ， 这 样 
的 方案 是 比较 现实 的 ， 并 且 成 本 方面 也 可 以 说 是 最 佳 的 。 

另外 ， 有 1 种 在 数据 库 模 式 更 新 后 即便 产生 bug 也 可 以 不 回 滚 数据 
库 模 式 的 技术 ， 那 就 是 将 现行 的 代码 和 下 次 发 布 的 代码 都 运行 在 数据 库 
更 新 后 的 状态 下 。 

测试 时 请 确认 即使 只 更 新 数据 库 的 模式 ， 现 在 的 代码 也 可 以 通过 
测试 。 

只 要 确保 即使 先 只 更 新 数据 库 ， 程 序 也 能 够 正常 运行 ， 就 不 必 回 滚 
数据 库 模 式 了 。 因 此 在 步骤 @ 发 现 比 发 布 前 性 能 慢 10 倍 的 情况 下 ， 只 
需要 回 退 代码 即 可 。 

采用 这 样 的 机 制 必须 能 够 分 别 实施 代码 的 版 本 管理 和 基于 迁移 工具 
的 数据 库 的 版 本 管理 ， 并 且 可 以 使 用 Fabric 或 Capistrano 来 实现 各 个 部 
署 、 回 滚 的 自动 化 。 



















































































五 
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6.7 ”本章 总 结 


至 今 为 止 全 手动 部 署 的 环境 想 要 实现 全 部 自动 化 ， 应 该 从 哪里 着 
手 ? 回答 是 “ 先 去 寻找 协助 者 和 出 资方 ”。 

部 署 的 自动 化 是 从 开发 人 员 、QA 团队 到 运 维 团 队 各 部 门 通力 协作 
的 产物 。 请 耐心 地 向 他 们 讲解 推进 部 署 自动 化 会 带 来 哪些 好 处 ， 以 推进 
团队 齐心 协力 。 

除了 团队 的 齐心 协力 之 外 ， 新 的 环境 以 及 构建 新 环境 所 需 的 时 间 也 
是 必 不 可 少 的 。 要 向 出 资方 、 公 司 的 管理 层 讲 解 部 署 自动 化 的 相关 内 
容 。 如 果 你 所 在 的 公司 拥有 充沛 的 资源 ， 并 且 提 供 了 类 似 于 Google 的 
“20% 规则 ”这 样 的 研究 时 间 ， 可 以 在 讲解 前 先 着 手 进行 自动 化 所 需 的 
工作 ， 通 过 演示 可 运行 的 系统 来 进行 讲解 。 如 果 能 够 频繁 地 向 客户 提供 
价值 ， 对 于 大 多 数 公 司 来 说 都 会 产生 好 的 影响 。 

如 果 团 队 内 部 有 不 合作 的 成 员 ， 最 初 他 们 可 能 会 觉得 麻烦 而 不 遵守 
既定 的 规则 ， 即 便 这 样 也 请 耐心 地 推进 自动 化 。 当 部 署 自动 化 开始 逐渐 
渗透 到 整个 团队 、 整 个 公司 时 ， 它 就 成 为 必 不 可 少 的 存在 了 。 

原来 的 部 署 需 要 专门 的 知识 和 经 验 ， 如 果 部 署 的 自动 化 开始 正常 运 
转 ， 那 么 这 样 的 知识 及 经 验 就 不 再 需要 了 。 工 作 人 员 也 可 以 通过 维护 自 
动 化 的 环境 ， 夜 间 得 以 安睡 ， 节 假日 可 以 享受 私人 时 间 。 而 从 公司 的 角 
度 来 说 ， 对 于 能 够 让 工程 师 笠 福 的 部 署 自动 化 ， 也 没有 理由 不 实施 。 








































































































-一 专栏 PaasS 的 使 用 方式 


什么 是 PaaS 

这 里 并 不 是 要 否定 本 章 的 内 容 ， 但 构建 自动 部 署 的 环境 总 要 花 
费 相 当 的 成 本 。 当 然 通过 实现 自动 化 应 该 能 够 获得 与 其 投资 相符 合 
的 收益 ， 但 那些 因为 项 目 生命 周期 短 而 希望 投资 最 小 化 的 情况 下 ， 
或 者 是 创新 公司 希望 尽早 获得 用 户 反 馈 的 情况 下 ， 可 以 考虑 使 用 
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PaaS ( Platform as a Service )。 

PaaS 是 一 种 由 运营 商 负责 提供 从 网 络 、OS 到 应 用 服务 器 等 中 
间 件 的 服务 。 因 为 PaaS 能 够 立即 提供 可 使 用 的 应 用 程序 运行 环境 ， 
所 以 开发 人 员 能 够 专心 发 工作 。 

PaaS 在 国内 外 有 Heroku、Force.com、Google App Engine、Cloud 
Foundry、OpenShift、AWS Elastic Beanstalk、DotCloud、Windows 
Azure、IJ GIOMOGOK、NIFTY Cloud C4SA 等 众多 提供 商 。 

选择 PaaS 时 要 注意 可 使 用 的 语言 及 语言 的 版 本 、 应 用 服务 器 
( Apache Tomcat/jetty 等 )、 可 使 用 的 数据 库 服务 、API 的 提供 、 可 
扩展 性 、 使 用 成 本 、 插 件 的 种 类 等 。 

以 Heroku 为 例 ， 登 录 账 户 后 从 管理 画面 上 传 应 用 程序 ， 只 要 
向 指定 的 远程 目录 实施 git push， 就 能 启动 Web 服务 了 。 无 需 安装 
或 调整 Apache， 只 需 在 管理 画面 增加 名 为 Dyno 的 Heroku 特有 的 
Web 服务 的 进程 数量 ， 就 能 够 处 理 大 量 的 请 求 。 开 发 人 员 只 需要 10 
分 钟 就 能 够 搭建 起 可 扩展 的 Web 服务 并 公开 。 
































































































































































































































































































































PaaS 的 适用 场景 
PaaS 能 够 方便 地 应 初期 的 小 规模 开发 ， 还 能 够 调整 规模 。 
针对 这 样 的 特点 ， 这 里 介绍 几 种 有 效 的 使 用 方法 。 

























































































@ 创新 公司 希望 尽早 公开 服务 
没有 足够 的 资源 构建 开发 环境 、 测 试 环境 、 正 式 环境 的 
情况 下 ， 不 要 直接 仅 构建 正式 环境 并 公开 服务 ， 而 是 利用 
PaaS 获取 用 户 的 反馈 并 反映 到 产品 中 ， 还 可 以 筹措 资金 等 。 
@ 无 法 预测 峰值 负荷 的 服务 
提供 手机 游戏 等 峰值 无 法 预测 的 服务 时 ， 可 以 利用 易于 
扩展 规模 的 PaaS。 当 服务 步 入 正轨 ， 形 成 可 预测 负荷 的 运营 
体制 后 ， 再 来 考虑 转移 到 公司 内 部 运 维 等 选项 。 
@ 生命 周期 短 的 服务 
例如 限定 期 限 为 1 个 月 的 展会 网 站 等 ， 也 可 以 使 
PaaS。 展 会 开始 时 收 到 大 量 请 求 的 情况 下 ， 可 以 预先 扩展 规 
模 进行 应 对 。 展 会 结束 后 再 缩减 规模 ， 这 样 就 能 够 以 最 少 的 
成 本 维持 服务 运营 ， 客 户 解 约 的 话 也 可 以 立即 停止 服务 。 像 
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这 样 ， 无 需 负担 多 余 的 资产 ， 非 常 适合 于 短 时 间 的 使 用 。 
@ 融入 到 企业 内 部 的 部 署 流水 线 中 
很 多 PaaS 都 可 以 使 用 全 球 公 开 的 URL， 因 此 可 用 于 营 
业 用 的 环境 ， 或 者 为 了 获取 特定 顾客 反馈 的 demo 环境 ， 这 
是 个 很 大 的 优点 。 


有 了 PaaS 就 不 需要 部 署 自动 化 了 ? 














在 适合 利 









































PaaS 的 下 列 缺 点 。 


PaaS 的 场景 范围 
。 但 是 ，PaaS 也 并 不 是 万 能 的 。 使 

















内 ， 


出 




















许可 以 说 不 需要 环境 的 配 


























PaaS 之 前 ， 请 仔 欠 





@ 服务 的 使 用 量 超过 一 定 限度 后 ， 费 用 会 激增 
e@ vendor lock-in" 的 风险 
@ PaaS 的 限制 和 应 用 程序 的 特性 不 相符 的 情况 

@ 发 生 问题 时 ， 有 时 难以 获得 调查 或 分 析 原因 用 的 日 志 
@ 向 云 运营 方 提出 的 监 查 要 求 可 能 不 被 接受 


@ 想 要 的 服务 等 级 ( service level ) 和 合同 内 容 或 SLA” ( Service 


Level Agreement ) 不 相符 的 情况 
@ 存在 因 无 法 确定 问题 原因 而 难以 追究 责任 的 情况 


当 服 务 的 规模 增长 至 














| 一 定 程 度 ，Paas 的 费 
































始 变 得 不 相符 ， 或 者 




















于 公司 的 规则 原本 就 和 
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和 提供 的 服务 等 级 
PaaS 的 限制 不 相符 
服务 时 ， 建 议 综 
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结合 定 


E 期 发 





















































合 等 情况 下 ， 就 很 难 继续 使 用 PaaS 了 。 在 规划 新 

合 考 虑 应 用 程序 的 特性 ， 探 讨 将 程序 部 署 到 哪里 。 
布 后 服务 的 增长 ， 需 要 重新 考虑 怎样 的 环境 才 是 合适 的 。 
离开 PaaS 的 时 机 


口 


可 以 考虑 将 在 PaaS 








上 公开 的 应 用 





程序 移植 到 AWS ( Amazon 

















Es 

























































































Web Services ) 等 的 laaS 环境 ， 或 者 自行 运营 的 公司 内 部 环境 中 。 例 
如 ， 由 于 超过 了 预计 的 访问 量 导致 PaaS 的 使 用 成 本 变 得 无 法 接受 等 

@D 过 度 依赖 特定 供应 商 的 独特 技术 进而 无 法 替换 为 其 他 供应 商 提供 的 同类 产 
品 。 译 者 注 

@， 服务 等 级 相关 的 事前 协议 。 主 要 是 系统 正常 运行 率 相关 的 赔偿 等 内 容 。 
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之 前 叙述 的 缺点 超过 使 用 PaaS 的 优点 时 ， 就 有 必要 移植 应 用 程序 。 
那么 ， 移 植 时 必须 注意 哪些 事项 呢 ? 主要 有 以 下 3 点 。 






























































@ 应 用 程序 运行 环境 的 构建 
@ 数据 的 移植 
@ 服务 的 切换 

















第 1 点 就 是 要 构建 新 的 应 用 程序 运行 环境 。 没 有 托管 的 服务 器 
组 或 者 自己 的 数据 中 心 的 情况 下 ， 可 以 使 用 AWS 等 的 laaS 环境 。 
构建 环境 时 可 以 一 边 参考 本 章 内 容 一 边 进 行 。 
第 2 点 是 处 理 持久 性 数据 时 ， 需 要 对 数据 进行 移植 。 如 果 持 久 
性 数据 保存 在 RDBMS 中 ， 可 以 取得 Dump 数据 ( 导出 数据 )， 并 预 
先 确认 好 导入 数据 的 操作 步骤 。 导 入 、 导 出 所 耗费 的 时 间 和 切换 环 
阐 时 服务 中 断 的 时 间 直接 相关 ， 因 此 需要 事先 验证 需要 消耗 多 少时 
间 。 支 持 增 量 备份 的 话 ， 可 以 预先 备份 好 实施 移植 之 前 的 部 分 ， 这 
样 能 够 使 服务 中 断 的 时 间 达 到 最 小 。 
第 3 点 是 服务 的 切换 。 如 果 使 用 域名 的 话 ， 可 以 预先 缩短 DNS 
记录 的 TTL ( Time To Live， 报 文 的 有 效 时 间 )， 为 能 够 在 瞬间 完成 
切换 做 好 准备 。 切 换 时 禁止 访问 旧 的 环境 ( PaaS )， 可 以 通过 显示 名 
护 画 面 来 防止 再 向 旧 的 环境 存储 数据 。 无 法 沿用 之 前 的 URL 的 情况 
下 ， 需 要 考虑 访问 旧 环 境 时 重 定向 到 新 环境 的 调整 方式 。 移 植 期 间 
需要 保留 旧 的 环境 ， 因 此 可 以 在 确认 访问 量 的 基础 上 来 决定 关闭 
环境 的 时 间 。 
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7.1 回归 测试 


至 此 ， 我 们 在 第 5 章 讲 了 持续 集成 ( Continuous Integration，CI )， 
在 第 6 章 讲 了 持续 交付 ( Continuous Delivery，CD ) 的 相关 内 容 。 本 章 
来 讲解 一 下 持续 测试 的 相关 内 容 。 


7.1.1 什么 是 回归 测试 





为 了 使 CI、CD 更 为 实用 ， 回 归 测 试 就 变 得 必 不 可 少 。 回 归 测 试 是 
以 检查 退化 为 目的 的 测试 。 虽 然 在 第 5 章 接 触 了 自动 化 测试 , 但 那 只 是 
从 开发 人 员 视 角 出 发 的 单元 测试 。 本 章 将 更 进一步 ， 来 看 一 下 从 用 户 视 
角 出 发 的 回归 测试 ， 即 集成 测试 、 用 户 验 收 测试 的 相关 内 容 。 

一 般 来 说 这 类 测试 和 使 用 系统 的 用 户 一 样 ， 利 用 浏览 器 进行 输入 或 
页 面 迁移 ， 并 测试 是 否 得 到 所 期 待 的 结果 或 页 面 。 因 此 执行 一 个 个 测试 
用 例 的 时 间 往 往 变 得 很 长 ， 如 果 是 长 年 运 维 的 系统 ， 到 所 有 测试 执行 结 
束 为 止 耗费 大 量 时 间 的 情况 并 不 罕见 。 
事实 上 ， 在 笔者 所 在 的 公司 ， 为 了 确认 前 一 天 提交 的 结果 是 否 通过 
回归 测试 ， 往 往 要 耗费 数 天 的 时 间 。 为 了 解决 这 个 问题 束 需 要 并 行 执行 
测试 。 
本 章 将 讲解 为 了 实现 针对 Web 服务 的 回归 测试 自动 化 所 必需 的 并 行 
测试 的 相关 工作 ， 以 及 具有 代表 性 的 用 户 验收 测试 自动 化 工具 Selenium 
的 使 用 方法 和 一 些小 技巧 。 

并 且 ， 以 确保 产品 质量 为 主要 职责 的 工程 师 ， 往 往 并 不 擅长 编程 。 
这 样 的 情况 下 应 该 如 何 实现 高 效 的 自动 化 回归 测试 呢 ? 对 于 这 个 问题 笔 
者 也 将 给 出 自己 的 答案 。 
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7.1.2 ”测试 分 类 的 整理 





了 
| 











F 发 中 需要 根据 不 同 目的 实施 各 种 种 类 的 测试 ， 并 且 其 数量 
之 多 ,往往 会 将 人 压 得 跨 不 过 气 来 。 因 此 在 进入 正题 之 前 ， 首 先 对 测 
试 这 一 概念 进行 简单 的 整理 。 开 发 流程 中 应 该 如 何 计划 并 实施 测试 ， 
以 及 什么 种 类 的 测试 和 发 现 怎样 的 bug 有关， 了解 上 述 内 容 是 进行 测试 
的 第 一 步 。 

测试 可 以 被 分 为 4 个 象限 “(图 7.1 ), 这 个 分 类 方法 将 各 种 测试 依据 
“业务 层面 看 到 的 ”和 “技术 层面 看 到 的 "， 以 及 “以 支持 团队 为 日 的 进 
行 的 ”和 “以 评价 产品 为 目的 进行 的 ”的 不 同 ， 用 2 根 轴 分 为 4 个 象 
限 ， 并 且 在 4 个 方块 中 给 出 了 各 类 测试 的 主要 手段 。 

下 面 对 各 象限 的 概要 进行 讲解 。 


图 7.1 ”测试 的 4 象限 


























































































































功能 测试 探索 测试 

( 例 ) 场景 ( scenario ) 测试 
原型 ( prototype ) 可 用 性 测试 

故事 ( story ) 测试 户 验收 测试 

仿真 ( simulation ) alpha/beta 测试 














症 2 旬 陶 | 便 3 系 限 
第 1 篆 限 ) | 全 4 系 限 























单元 测试 安全 测试 
组 件 测试 性 能 /负载 测试 
“~ 性 ”测试 















































技术 层面 


四 ( 美 ) Janet Gregory、Lisa Crispin 著 ， 孙 伟 峰 、 鹤 康 译 《敏捷 软件 测试 : 测试 人 员 
与 敏捷 团队 的 实践 指南 》 清华 大 学 出 版 社 ，2010 年 。 
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ol 支持 团队 的 技术 层面 的 测试 ( 第 1 象限 ) 


基于 单元 测试 的 测试 驱动 开发 ( Test Driven Development, TDD ) 





等 开发 中 的 主要 测试 。 主 要 是 和 内 部 品质 相关 的 内 容 ， 代 码 的 版 本 管理 


系统 











集成 开发 环境 ( Integrated Development Environment， 简 称 IDE )， 


以 及 编译 自动 化 工具 等 也 属于 这 个 范畴 。 





i 支持 团队 的 业务 层面 的 测试 ( 第 2 象限 ) 





与 第 1 象限 偏 技术 相对 ， 该 象限 是 更 接近 于 业务 的 顾客 观点 的 测 

















试 。 除 了 功能 测试 以 外 ， 原型、 仿真 、 需 求 以 及 画面 设计 等 以 推进 开发 


为 目的 的 活动 也 可 以 作为 一 种 测试 在 此 进行 。 








并 且 ， 这 里 的 测试 是 用 负责 业务 的 工作 人 员 能 够 理解 的 语言 











来 记述 的 ， ， 这 些 测试 中 的 大 多 数 都 应 该 、 且 已 经 实现 了 自动 化 。 该 领域 
还 包括 借助 Fit?、Selenium .Cucumber”、Watir* 以 及 Canoo WebTest 























的 自动 化 测试 。 
e…… 评价 产品 的 业务 层面 的 测试 ( 第 3 象限 ) 


从 业务 的 视角 出 发 , 为 了 评价 产品 而 进行 的 测试 。 探 索 测 试 ”、 可 用 








性 测试 “以 及 用 户 验收 测试 “属于 这 个 象限 。 




















基本 上 是 以 对 用 户 接触 的 部 分 进行 测试 为 中 心 ， 相 对 于 第 1、 第 2 





象限 侧重 于 自动 化 方面 ， 这 是 只 能 由 人 手动 实施 的 测试 。 





http://fit.c2.com/ 

http://cukes.info/ 

http://watir.com/ 

http://webtest.canoo.com/ 

一 种 探索 着 进行 的 测试 。 不 是 根据 事前 准备 好 的 测试 计划 来 执行 测试 用 例 ， 而 是 
一 边 熟悉 产品 一 边 对 可 和 疑 之 处 进行 测试 ， 并 根据 测试 结果 随机 应 变 地 进行 下 一 步 
测试 。 

从 用 户 的 视角 来 确认 产品 的 UI ( 用 户 接口 ) 哪里 有 问题 的 测试 。 

检验 完成 后 的 产品 是 否 满足 需求 规约 的 测试 。 
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@…… 使 用 技术 层面 测试 的 产品 评价 ( 第 4 象限 ) 
性 能 测试 、 安 全 性 测试 等 ， 基 本 上 不 使 用 技术 就 难以 实施 的 测试 。 
SHH 
针对 开发 流程 中 应 该 注重 哪些 目的 ,或 者 说 可 以 省 略 哪 一 部 分 ， 可 
以 对 照 着 测试 的 4 个 象限 来 确立 测 斌 方针。 另外， 为 了 确认 正在 实施 或 
者 即将 实施 的 测试 是 出 于 什么 目的 的 等 ， 也 可 以 参考 测试 的 4 个 象限 ， 
这 样 在 团队 以 及 组 织 内 容易 达成 共识 。 























7.1.3 回归 测试 的 必要 性 


@…… 退化 ( degrade ) 的 发 生 


1 于 系统 的 版 本 更 新 ， 在 之 前 的 版 本 中 正常 运行 的 功能 变 得 无 法 正 
常 运行 ， 或 者 紧急 修正 了 某 个 问题 ， 但 引发 了 其 他 新 的 问题 …… 想 必 谁 
都 经 历 过 这 种 退化 的 现象 吧 。 
虽说 如 此 ， 为 了 在 代码 变更 时 保证 质量 ， 既 然 无 法 预测 系统 的 何 处 
会 发 生 退 化 ， 就 必须 实施 回归 测试 以 确认 没有 预想 外 的 影响 发 生 。 

并 且 ， 如 果 通 过 回归 测试 发 现 了 bug， 为 了 确认 bug 还 需要 更 进 一 
步 实施 回归 测试 。 但 是 这 样 的 测试 流程 需要 较 多 的 时 间 ， 因 此 如 果 不 实 
现 自动 化 ， 在 实际 项 目 中 就 很 少 会 被 运用 。 































































































e@…… 应 该 实现 自动 测试 的 原因 


那么 应 该 怎么 做 呢 ? 从 修改 的 代码 确定 影响 范围 ， 再 从 重要 程度 等 
风险 的 观点 出 发 确定 测试 范围 后 实施 测试 ， 这 可 能 是 一 般 的 作法 。 但 是 
笔者 认为 通过 实现 回归 测试 的 自动 化 ， 每 次 都 执行 所 有 的 测试 用 例 ， 能 
够 最 有 效 地 保证 质量 。 

人 为 判断 执行 哪些 测试 用 例 本 身 就 可 能 产生 失误 。 根 据 时 间 的 限 种 
来 决定 可 以 执行 的 测试 范围 和 测试 量 ， 最 终 只 要 不 执行 所 有 的 测试 用 
例 ， 还 是 难免 会 担心 。 

实现 测试 的 自动 化 还 会 带 来 其 他 的 一 些 好 人 处。 正如 我 们 在 第 5 章 中 
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说 明 的 那样 ， 每 次 提交 后 执行 测试 ， 如 果 能 够 即刻 发 现 问 题 ， 那 么 问题 
就 能 被 迅速 地 解决 。 
若 提交 1 周 后 才 收 到 当时 的 修改 引发 了 新 的 问题 这 样 的 报告 ， 有 时 
就 需要 先 回想 一 番 后 才能 着 手 。 因 此 实现 测试 的 自动 化 ， 频 繁 地 实施 测 
试 还 能 够 加 快 开发 速度 。 

为 了 减少 退化 bug 要 怎么 做 才 好 呢 ? 在 此 之 前 人 们 为 了 减少 退化 
bug 进行 了 各 类 尝试 ， 得 到 的 答案 是 : 通过 人 工 测试 来 保证 质量 ， 从 效 
率 以 及 速度 上 来 说 都 有 其 局 限 性 ， 只 有 通过 自动 测试 才 行 。 从 在 此 之 前 
的 手动 测试 转变 为 重视 自动 测试 ， 发 生 退 化 的 数量 也 得 以 大 幅 减 少 (图 
7.2、 图 7.3)s 


















































图 7.2 ”通过 自动 测试 发 现 的 bug 在 所 以 被 发 现 的 bug 中 所 占 的 比例 
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图 7.3 ”退化 数量 的 变化 
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当然 自动 测试 的 效果 根据 产品 的 特性 会 有 所 变化 ， 但 不 难看 出 ， 无 
是 对 于 提高 产品 的 质量 还 是 顺利 推进 开发 来 说 ， 回 归 测 试 的 自动 化 都 
重要 的 因素 。 











LV 


和 车 





7.1.4 回归 测试 自动 化 的 目标 


说 起 实现 回归 测试 的 自动 化 ， 之 前 叙述 的 各 个 种 类 的 测试 中 哪些 应 
该 实现 自动 化 呢 ? 首先 ， 一 般 来 说 是 由 开发 人 员 实 施 的 单元 测试 。 可 是 
无 论 单 元 测试 的 覆盖 率 如 何 提升 ， 仅 靠 单元 测试 是 无 法 保证 产品 的 质量 
的 。 单 元 测试 作为 确保 程序 的 动作 和 开发 人 员 的 意图 相 一 致 的 测试 ， 即 
使 达到 100% 的 覆盖 率 ， 还 是 有 如 下 这 些 bug 无 法 发 现 。 

















@ 在 程序 中 的 for 或 while 这 样 的 循环 中 ， 不 进入 循环 体 或 者 超过 
了 最 大 循环 次 数 等 边界 值 相关 的 bug 

@ 包含 预料 之 外 的 数据 时 的 异常 处 理 不 充分 而 导致 的 bug 

@ 共享 内 存 的 操作 或 数据 库 的 锁 处 理 等 ， 由 于 进程 、 线 程 间 共享 数 
据 而 在 特殊 的 时 间 点 发 生 的 bug 

@ 使 用 了 中 间 件 的 某 个 特定 版 本 ( Web 服务 器 、 数 据 库 服务 器 、 邮 
件 服务 器 等 ) 而 产生 的 bug 

e@ 需求 自身 的 问题 所 造成 的 bug 

e@ 功能 未 完成 而 造成 的 bug 


多 数 系 统 会 使 用 数据 库 服 务 器 或 缓存 服务 器 这 样 的 中 间 件 ， 或 者 通 
过 API 调用 其 他 Web 服务 的 资源 ,很 多 功能 仅 有 系统 自身 无 法 运行 ， 
因此 就 需要 在 和 实际 产品 相同 的 环境 下 进行 测试 。 并 且 还 有 可 能 发 生 和 
j 户 所 使 用 的 OS 及 浏览 器 相关 的 bug。 因 而 需要 对 各 种 条 件 下 系统 的 
运行 要 求 是 否 得 到 满足 进行 测试 。 

所 以 ， 不 仅仅 是 单元 测试 ， 还 需要 从 最 终 使 用 系统 的 用 户 视角 出 发 
的 集成 测试 。 不 过 值得 庆幸 的 是 ， 这 种 集成 测试 的 自动 化 工具 正在 不 断 
地 被 开发 出 来 。 下 面 讲解 的 作为 Web 应 用 程序 测试 框架 的 Selenium 就 
是 一 款 著名 的 测试 工具 。 
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7.2 Selenium 


7.2.1 什么 是 Selenium 


Selenium 是 实现 Web 应 用 程序 的 功能 测试 以 及 集成 测试 自动 化 的 
浏览 器 驱动 测试 工具 群 ， 具 备 以 Web 应 用 程序 的 测试 自动 化 为 特点 的 各 
类 功能 。 
和 使 用 系统 的 用 户 相同 ， 在 浏览 器 上 进行 的 鼠标 操作 、 在 表单 中 输 
人 文字 或 者 打开 页 面 时 ，Selenium 能 够 检查 页 面 的 内 容 是 否 正确 显示 、 
检查 表单 的 值 以 及 验证 页 面 内 执行 的 JavaScript 等 。 因 此 借助 Selenium 
能 够 重复 实施 至 今 为 止 手 动 操作 的 测试 。 























| 
























































7.2.2 Selenium 的 优点 








下 面 介 绍 一 下 Selenium 的 主要 特点 。 











。…… 自动 化 测试 用 例 制作 简单 


首先 是 测试 用 例 的 制作 非常 简单 。Selenium 提供 了 名 为 Selenium 
IDE ”的 工具 。 该 工具 具备 记录 ( capture ) 键盘 或 鼠标 的 操作 并 播放 
( replay ) 的 “capture* replay” 功 能 ， 能 够 非常 简单 地 制作 测试 用 例 。 

因为 能 直接 根据 浏览 器 上 的 操作 生成 测试 用 例 ， 所 以 不 善于 编程 的 
工程 师 也 能 简单 地 制作 自动 测试 用 例 。 

































































@…… 支持 多 种 浏览 器 及 OS 
其 次 是 测试 可 使 用 的 浏览 器 种 类 多 样 。 现 在 支持 的 浏览 咒 有 Internet 

















OD http:/www.seleniumhq.org/ 
@) 还 有 名 为 Selenium Builder 的 Selenium IDE 的 后 续 工具 。 
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Explorer (简称 IE )、FireFox 、Chrome 、Safari 、Opera 、iPhone 标准 的 
浏览 器 ( Safari )、Android 标准 的 浏览 器 ， 可 以 说 是 支持 了 所 有 主要 的 
浏览 句 。 并 且 还 支持 Windows、OS X、Linux 、Solaris 等 多 种 OS 。 

无 论 对 功能 进行 如 何 详尽 的 测试 ， 如 果 在 FireFox 上 正常 运行 ,在 
IE 上 无 法 运行 的 话 ， 这 样 是 没有 意义 的 。 因 此 Selenium 支持 在 各 种 浏 
览 器 上 执行 同样 的 测试 用 例 。 

在 系统 支持 的 所 有 浏览 器 上 手动 执行 同样 的 测试 是 一 件 非 常 无 获 旦 
麻烦 的 工作 。 这 样 繁琐 的 作业 就 应 该 实现 自动 化 。 






































7.2.3 ”Selenium 的 组 件 




















如 上 所 述 ，Selenium 作为 自动 测试 Web 应 用 程序 的 工具 群 ， 是 由 多 
个 组 件 (工具 ) 构成 的 。 根 据 运行 方式 的 不 同 ， 所 使 用 的 组 件 也 有 所 差 
异 。 这 里 简单 地 介绍 一 下 具有 代表 性 的 Selenium IDE 、Selenium Remote 
Control 和 Selenium WebDriver。 


























@…… Selenium IDE 


Selenium IDE "是 Selenium 测试 用 的 IDE, 是 一 款 支持 从 测试 用 例 的 
制作 到 执行 、 调 试 的 Firefox 的 插件 ( 图 7.4 )。 

Selenium IDE 能 够 通过 录制 浏览 器 的 操作 来 制作 测试 用 例 ， 编 辑录 
制 的 测试 用 例 时 还 支持 自动 补足 (autocomplete )， 因 此 非常 方便 。 并 
且 制 作 的 测试 用 例 能 够 当场 立即 执行 ， 还 能 够 通过 在 测试 用 例 中 设置 
断 点 来 确认 执行 暂停 时 的 状态 ， 可 以 说 是 高 效 地 制作 测试 用 例 必 不 可 少 
的 工具 。 

没有 使 用 过 Selenium 的 人 ， 可 以 从 使 用 Selenium IDE 开始 ， 来 熟 
悉 Selenium 的 测试 用 例 。 

























































































OD http:/www.seleniumhq.org/projects/ide/ 
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7.4 Selenium IDE 

















ee@e Selenium IDE 2.8.0 

Base URL http://www.baidu.com/ Ng 
Command Target Value 
Command v 
Target v Select Find 
Value 

reterence Ub-Element Rollup Infov Clear 





























OO Selenium Remote Control ( Selenium RC ) 


Selenium Remote Control”( 以 下 简称 Selenium RC 或 Seleniuml ) 和 
Selenium IDE 一 样 也 是 自动 测试 Web 应 用 程序 的 工具 ( 图 7.5 )。 但 是 ， 
不 同 于 Selenium IDE 自身 就 能 制作 测试 用 例 并 执行 测试 ，Selenium RC 
需要 在 运行 浏览 器 的 机 器 上 启动 名 为 Selenium Server 的 服务 器 ， 该 服 
务 器 用 于 中 继 测试 脚本 (测试 用 例 ) 和 浏览 器 ， 并 通过 该 服务 器 来 执行 
测试 。 








OD http:/www.seleniumhq.org/projects/remote-control/ 
@) Selenium Server 就 是 Selenium WebDriver 发 布 之 前 的 称 为 “Selenium RC Server” 的 
中 继 服 务 器 ， 和 WebDriver 合并 成 为 Selenium2 后 开始 改名 为 “Selenium Server”。 
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图 7.5 使 用 Selenium RC 的 构造 








操作 浏览 














Selenium Core 


| 浏览 器 








发 送 测试 命令 





























测试 脚本 








Selenium RC 可 以 启动 、 终 止 测试 用 的 浏览 需 、 执 行 测试 脚本 上 的 
浏览 器 操作 命令 等 ， 还 能 够 起 到 类 似 于 HTTP 代理 的 功能 ， 因 此 可 以 在 
Firefox 以 外 的 多 种 浏览 器 上 执行 测试 。 并 且 Selenium RC 还 提供 了 各 种 
语言 "能够 调用 的 API， 因 此 可 以 使 用 各 种 编程 语言 制作 测试 用 例 。 利 











用 编程 语言 来 




















剖 作 测试 用 例 ， 可 以 实现 循环 处 理 以 及 分 支 条 件 ， 还 可 以 





将 共通 处 理 做 成 库 ， 因 此 可 以 制作 出 更 为 高 效 的 测试 用 例 ”。 


@…… Selenium WebDriver 





Selenium 是 一 款 非 常 优秀 的 测试 工具 ， 但 由 于 操作 浏览 器 的 引擎 部 





中 主要 可 使 用 的 语言 有 Java、Ruby、Python、Perl、PHP、.NET。 

@， 即将 发 布 的 Selenium3 将 不 推荐 使 用 Selenium RC。 虽 然 本 书 提 到 了 较 多 关于 
Selenium RC 的 内 容 ， 但 开始 新 的 项 目 时 还 是 推荐 使 用 Selenium WebDriver。 
http://seleniumhq.wordpress.com/2013/08/28/the-road-to-selenium-3/ 
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分 是 基于 JavaScript 的 ， 因 此 经 常会 受到 浏览 器 的 安全 限制 。 随 着 Ajax 
(Asynchronous JavaScript and XML ) 的 普及 ， 越 来 越 多 的 Web 应 用 程序 
开始 使 用 JavaScript， 这 个 问题 也 变 得 越发 严重 。 

男 一 方面 ， 从 2006 年 前 后 开始 ， 为 了 解决 JavaScript 限制 的 问题 ， 
Google 的 Simon Stewart 开始 开发 名 为 WebDriver 的 项 目 (图 7.6), 通 
过 调用 OS 的 原生 接口 来 操作 浏览 


7.6 使 用 Selenium2 的 构造 























浏览 器 























测试 脚本 











WebDriver 项 目 和 Selenium 项 目 能 够 互补 ， 为 用 户 提 供 更 好 的 测试 
框架 ， 基 于 这 个 原因 ， 两 者 被 合并 在 一 起 ， 并 发 布 了 Selenium WebDriver 
(以 下 称 为 Selenium2 )。Selenium2 发 布 后 ， 原 来 的 Selenium RC 就 被 称 
为 Seleniuml 了 。 

Selenium2 结合 了 Seleniuml 的 “支持 多 种 浏览 器 *” “丰富 的 测试 描 
述 语言 ”的 优点 ， 以 及 WebDriver 的 “在 JavaScript 沙 箱 ( sandbox ) 外 








中 http:/www.seleniumhq.org/projects/webdriver/ 
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部 运行 ”“ 高 速 轻 量 且 通 用 的 浏览 器 仿真 器 ”的 优点 "。 


7.2.4 测试 用 例 的 制作 和 执行 


下 面 我 们 就 来 看 一 下 如 何 制作 Selenium 的 测试 用 例 。 














全 Selemium IDE 的 安装 和 运行 


Selenium IDE 是 Firefox 的 插件 。 用 Firefox 打开 http://www. 
seleniumhq .org/download/， 点 击 最 新 版 本 的 链接 ， 即 可 进行 安装 。 

启动 Selenium IDE， 在 浏览 器 上 迁移 画面 、 输 入 文字 就 可 以 直接 将 
操作 记录 为 命令 ， 只 需 几 分 钟 就 可 以 制作 好 简单 的 测试 用 例 。 接 着 执行 
测试 用 例 ， 就 可 以 检验 系统 是 否 正常 运行 。 




















Oe Selenium 的 测试 用 例 


简单 地 说 一 下 Selenium 的 测试 用 例 。Selenium 的 测试 用 例 可 以 用 多 
种 编程 语言 来 制作 ， 这 里 说 明 的 是 用 Selenium IDE 制作 的 HTML 形式 
的 测试 用 例 。 

Selenium 的 测试 用 例 由 多 个 测试 用 例 和 测试 套件 ( test suite ) 构成 。 
测试 套件 由 多 个 测试 用 例 组 合 而 成 。 通 过 组 合成 为 测试 套件 ， 多 个 
测试 用 例 就 能 按照 指定 的 顺序 执行 ( 图 7.7 )。 






























































中 具体 请 参考 http://www.seleniumhq.org/docs/01_introducing_ selenium.jsp#brief-history- 


of-the-selenium-project。 
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归 测试 











图 7.7 ”使 用 测试 套件 的 结构 示例 





testsiute01.html ( 测试 套件 ) 

















login_successful.html ( 测试 用 例 ) 























login_failed.html ( 测试 用 例 


testsiute02.html ( 测试 套件 ) 

















create_user.html ( 测试 用 例 ) 




















create_user_error.html ( 测试 用 例 ) 














在 Selenium IDE 中 建立 多 个 测试 用 例 后 ， 点 击 “New Test Suite” 就 
能 建立 测试 套件 。 用 编辑 器 打开 建 好 的 测试 套件 ， 就 可 以 看 到 连接 到 各 
个 测试 用 例 的 链接 ， 如 代码 清单 7.1 和 代码 清单 7.2 所 示 。 


代码 清单 7.1 测试 套件 的 例子 ( testsuite01.html ) 


<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD 
XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1l/DTD/xhtml1l-strict. 
dtd"><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" 
lang="en"><head><meta content="text/html; charset=UTF-8" http- 











TT 











equiv="content-type" /><title>Test Suite</title></head> 
<body> 
<table id="suiteTable" cellpadding="1" cellspacing="1" border="1" 
class="selenium"> 
<tbody><tr> 
<td><b>login</b></td> 
NEE> 
< 
<td><a href="login successful.html">login successful</a></td> 
</tr> 
< 七 下 之 
<td><a href="login failed.html">login failed</a></td> 
/Er 
</tbody> 
</table> 
</body> 
</html> 
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代码 清单 7.2 测试 用 例 的 例子 ( login_successful.html ) 


<?x 邮 件 列 表 version="1.0" encoding="UTF-8"?> 
<1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www. 
we ove/TR ne mmm sr do 
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en'"> 
<head profile="http://selenium-ide.openqa.org/profiles/test-case"> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
<link rel="selenium.base" href="http://example.com/" /> 
<title>login successful</title> 
</head> 
<body> 
<table cellpadding="1" cellspacing="1" border="1"> 
<thead> 
=trS=Ea rowspan=M eolspan un Eeste /Ed /EE 
</thead><tbody> 
= 
<td>open</td> 
<td>/</td> 
dss td 
EE 
< 
<td>waitForTextPpresent</td> 
<td>ID、 请 输入 密码 </td> 
<td></td> 
二 
忌 七 关 > 
<td>type</td> 
od oo md 
<td>admin</td> 
过 /全 下 > 
忌 蕊 芝 > 
<td>type</td> 
<td>id=loginpPassword</td> 
<td>admin</td> 
/EE 
EE 
<td>clickAndWait</td> 
=tapna ogni/ 
<td></td> 
Py 
EE 
<td>verifyTextPresent</td> 
<td>You are signed in to these accounts: </td> 
<td>s</tds 
二 
</tbody></table> 
</body> 
</html> 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊 


EE 


ul 





习 


版 权 





274 | 第 7 章 回归 测试 











e@…… 什么 是 好 的 测试 用 例 


虽说 测试 越 快 完成 越 好 ， 但 据说 “用 Selenium 测试 非常 费时 ”。 如 
测试 要 耗费 几 个 小 时 的 话 ， 那 么 频繁 地 执行 测试 就 比较 困难 了 ， 只 能 
将 多 个 修改 合 在 一 起 进行 测试 ， 但 这 样 测试 失败 时 就 难以 分 析 原 因 了 。 
并 有 旦 车 提交 数 天 后 才 发 现 有 bug， 开 发 的 节奏 也 会 受到 影响 ， 无 法 高 效 
地 进行 。 

制作 测试 用 例 、 执 行 测 试 、 确 认 结果 ， 然 后 再 制作 测试 用 例 、 执 行 
测试 、 确 认 结 果 …… 为 了 让 开发 人 员 能 够 像 这 样 频繁 地 进行 测试 ， 测 试 
再 长 也 应 该 在 30 分 钟 内 结束 。 为 了 缩短 测试 时 间 ， 在 开始 制作 测试 用 
例 时 就 需要 考虑 下 面 这 几 点 。 



























































e@ 单独 执行 各 个 测试 套件 也 必须 能 够 通过 测试 
e@ 1 个 测试 套件 的 执行 时 间 不 能 超过 所 预期 的 全 部 测试 的 构建 时 间 








各 个 测试 套件 必须 能 够 独立 执行 ， 依 赖 于 其 他 测试 套件 的 就 说 不 上 
是 好 的 测试 套件 。 这 是 因为 ， 如 果 测 试 套件 之 间 相 互 依赖 的 话 ， 就 必须 
按照 固定 的 顺序 执行 ， 这 样 一 来 就 难以 实现 并 行 执行 ， 测 试 的 时 间 也 会 
逐渐 拉 长 。 

相反 ， 如 果 测 试 套件 之 间 相 互 独立 ， 就 有 可 能 将 运行 所 有 测试 的 时 
间 缩 短 到 和 最 长 的 测试 套件 的 执行 时 间 相 同 。 因 此 在 制作 测试 用 例 时 要 
时 刻意 识 到 上 述 两 点 。 
































@…… 用 Selenium Server 来 运行 测试 


Selenium IDE 在 制作 测试 用 例 方面 是 非常 强大 的 开发 工具 ， 但 并 不 
适用 于 定期 、 持 续 地 执行 测试 用 例 。 也 就 是 说 ， 开 始 测试 时 必须 在 运行 
浏览 器 的 机 器 上 点 击 Selenium IDE 的 开始 测试 按钮 。 随 着 测试 用 例 的 逐 
渐 增 加 ， 这 样 的 测试 手段 可 以 说 将 变 得 越 来 越 不 现实 。 

为 了 解决 上 述 问题 ， 下 面 将 介绍 使 用 Selenium Server 来 执行 用 
Selenium IDE 制作 的 测试 用 例 的 方法 。 
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下 载 Selenium Server 后 “, 通过 下 列 命令 运行 Selenium Server, 就 能 
够 解析 HTML 格式 的 测试 用 例 、 启 动作 为 测试 对 象 的 浏览 器 、 执 行 测试 
并 输出 测试 结果 的 报告 。 


C:\>java -jar selenium-server-standalone-<version-number>.jar -htmlSuite 
"x¥#firefox" 

"http://example.com" "C:\path\to\testsuite01.html" 

ve Npath\to\resuwlte nem 


命令 的 选项 
e><resultFile> 构 成 。 可 以 通过 选项 -h 来 查看 选项 列表 。 
C:\>java -jar selenium-server-standalone-<version-number>.jar -h 


来 看 一 下 上 述 命令 的 例子 中 -htmlsuite 选 项 的 相关 内 容 。 

第 1 个 参数 “*firefox” 表 示 进 行 测试 的 浏览 器 的 种 类 。 修 改 为 
“x*iexplore” 的 话 就 可 以 使 用 正 进行 测试 。 

第 2 个 参数 “http://example.com” 是 Base URL。 对 系统 的 多 个 不 同 
版 本 执行 相同 的 测试 用 例 的 情况 下 使 用 该 参数 。 测 试用 例 的 open 命令 
所 指定 的 URL 的 路 径 ( 相对 路 径 ) 就 是 基于 这 个 由 Base URL 指定 的 域 
名 的 ， 并 作为 绝对 URL 来 执行 。 例 如 ， 在 有 开发 团队 A 用 的 测试 环境 
( http://a.example.com ) 和 团队 B 用 的 测试 环境 ( http://b.example.com ) 
这 样 的 情况 下， 可 以 使 用 这 个 参数 。 

第 3 个 参数 “Ci:\path\to\testsuite01.html” 是 测试 套件 文件 的 路 径 。 
请 指定 绝对 路 径 。 

第 4 个 参数 “Ci:\path\to\results.html” 是 测试 结果 报告 的 生成 路 径 。 
同样 要 指定 绝对 路 径 。 

这 样 通过 使 用 Selenium Server， 就 不 必 从 Selenium IDE 手动 开始 执 
行 测试 了 ,配合 使 用 Cron ?或 Jenkins 就 能 够 定期 地 执行 测试 ,并 且 还 能 
够 在 Linux 或 Mac OS 等 多 个 操作 系统 上 测试 多 种 浏览 

至 此 ， 我 们 讲 了 使 用 Selenium IDE 制作 测试 用 例 ， 利 用 Selenium 
Server 执行 测试 的 相关 内 容 。 这 样 就 可 以 利用 Selenium 执行 持续 的 集成 
测试 了 。 


























日 -htmlSuite<browser><startURL><suiteFil 

























































































中 可 以 从 http://www.seleniumhq.org/download/ 下 载 。 
@ 自动 执行 任务 的 守护 程序 。 
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7.2.5 ”Selenium 的 实际 应 用 


e@-…… 测试 页 面 是否 有 改动 


根据 系统 或 功能 所 要 求 的 品质 的 级 别 ， 存 在 不 允许 预期 以 外 的 画面 
变更 的 情况 。 另 外 有 的 公司 必须 保存 并 提交 画面 的 截图 作为 实施 测试 的 
证 据 。 这 时 就 可 以 使 用 Selenium 的 画面 截图 功能 ， 实 现 打 开 画 面 后 截图 
这 种 麻烦 的 作业 的 自动 化 。 这 里 将 介绍 画面 截图 的 方法 ， 以 及 将 获取 的 
截图 和 以 前 的 截图 进行 比较 、 测 试 的 方法 。 

Selenium 可 以 通过 “captureEntirePageScreenshot” 或 “captureEntireP 
ageScreenshotAndWait ”命令 来 截取 当前 浏览 吉 的 画面 (图 7.8 )。 纵 向 
较 长 的 画面 也 能 深 动 后 截取 下 来 。 在 保存 的 文件 名 中 输入 “Ci:\path\to\ 
imgvcapturel.png” 这 样 的 绝对 路 径 来 保存 截图 。 不 设 定 背景 色 的 话 会 输 
出 黑色 的 背景 ， 所 以 可 以 预先 设置 好 “background=#FFFFFF” 等 。 


4 







































































<td>captureEntirePageScreenshot</td> 
<td>C:\path\to\img\capturel .png</td> 
<td>background=#FFFFFF</td> 

</ErES 


接着 说 一 下 对 保存 的 画面 截图 进行 比较 测试 的 方法 。 例 如 ， 将 系统 
版 本 1 时 截取 的 画面 和 即将 发 布 的 版 本 2 所 截取 的 画面 进行 比较 。 对 版 
本 1 和 版 本 2 执行 相同 的 Selenium 测试 用 例 ， 各 自 输出 同名 的 截图 文 
件 ， 分 别 存放 在 C:\path\to\img\v1 和 Ci:\path\to\img\v2 这 两 个 日 录 下 。 

图 像 的 比较 采用 名 为 ImageMagick" 的 图 像 处 理 软件 来 进行 。 安 装 
ImageMagick 后 执行 下 列 命 令 。 可 以 利用 本 书 提供 的 脚本 “来 比较 目录 
下 的 所 有 图 像 ， 并 以 HTML 文件 的 形式 输出 结果 。 


C:\>composite.exe -compose difference C:\path\to\img\vi\capturel .png 
C:\path\to\img\v2\capturel.png C:\path\to\img\diff\capturel.png 















































QD http:/www.imagemagick.org/ 
@ ”ImageMagick 的 下 载 地 址 为 http:/www.imagemagick.org/script/binary-releases.php。 
@) 打开 http://www.ituring.com.cn/book/1495， 点 击 “ 随 书 下 载 ”。 
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图 7.8 ”截取 画面 的 例子 
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可 以 通过 高 光 的 图 像 来 确认 比较 结果 中 存在 差异 的 部 分 (图 7.9 )。 
通过 比较 画面 截图 的 方法 ， 能 够 发 现 测 试 工程 师 无 论 如 何 测试 都 无 法 发 
现 的 问题 ， 请 一 定 要 试 一 下 。 
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7.9 ”附录 脚本 的 执行 结果 文件 





Test suite results 


image-difr 
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Oe 使 Selenium 测试 稳定 运行 


Selenium 的 自动 测试 并 不 是 很 稳定 。 经 常 听 说 系统 明明 正常 运行 ， 

测试 却 失败 了 这 样 的 事情 。 例 如 ， 点 击 链接 ， 在 画面 加 载 完成 前 挂 起 下 
一 步 操作 的 cLickandwait 命令 执行 时 ， 点 击 链接 迁移 到 下 一 个 页 面 
并 试图 点 击 页 面 内 的 按钮 ， 但 无 法 找到 该 按钮 而 造成 测试 失败 。 
上 述 情况 下 ， 因 为 cl1ickAndWait 命 令 执 行 成 功 ， 所 以 下 一 个 页 
而 应 该 已 经 加 载 完成 了 ， 那 为 什么 无 法 点 击 本 应 正常 显示 的 按钮 而 测试 
失败 了 呢 ? 能 够 想到 的 原因 有 服务 器 内 部 的 数据 备份 或 执行 的 测试 造成 
服务 器 的 负载 变 高 ， 对 浏览 器 的 响应 速度 变 慢 等 。 

但 其 实测 试 失败 的 本 质问 题 在 于 服务 器 的 响应 速度 慢 ， 在 页 面 内 容 
还 没有 加 载 完毕 的 状态 下 Selenium 就 执行 了 下 一 条 命令 ， 从 而 导致 测试 
失败 。 刚 才 的 例子 中 ，Selenium 虽然 用 cl1ickAndwait 命 令 等 待 画面 
加 载 ， 但 没有 等 待 该 画面 中 接着 要 点 击 的 按钮 加 载 完 毕 就 直接 执行 了 下 
一 条 命令 ， 所 以 造成 了 测试 失败 。 

作为 Selenium 的 创始 人 、 公 司 的 CTO ，S$auce Labs 在 博客 中 这 样 
叙述 。 
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"Selenium tests often fail because 如 ey 7e too fast. Where a user 
might wait for a page to load for a few seconds and then click on a 
link, Selenium will interact with a page at the speed of code, before the 
page is ready.”Selenium 的 测试 经 常会 因为 速度 过 快 而 造成 失败 。 
人 为 操作 的 话 会 等 待 画面 显示 后 再 点 击 链接 ，Selenium 则 是 在 画 
面 完 全 显示 之 前 以 执行 程序 的 速度 实施 测试 的 。 


How to Lose Races and Win at Selenium ( http://sauceio.com/index.php/2011/04/ 





how-to-lose-races-and-win-at-seleniumy ) 








通常 ， 人 为 操作 浏览 器 时 会 等 待 按钮 显示 或 页 面 加载 完 后 再 进行 之 
后 的 操作 ， 而 Selenium 则 是 直接 继续 之 后 的 操作 。 

该 如 何 解决 这 个 问题 呢 ? 解决 方法 之 一 就 是 在 使 用 clickandwait 
命令 等 进行 画面 迁移 之 后 ， 和 暂停 (pause ) 固定 数秒 钟 的 时 间 ， 通 过 延迟 
执行 下 一 条 命令 ， 多 少 能 够 所 有 改善 。 但 这 个 方法 为 了 解决 偶尔 发 生 的 
问题 不 得 不 在 测试 用 例 的 各 处 插入 pause 命令 ， 会 造成 测试 执行 时 间 
变 长 ， 因 此 并 不 推荐 。 作 为 其 他 的 解决 方案 ， 上 述 微 博 中 还 提 到 了 下 面 
的 内 容 。 
























































“The way to fix this is to have Selenium repeat its actions and 
assertions until they work. Jf you don’t, Selenium races your browser.” 
为 了 解决 这 个 问题 ，Selenium 在 得 到 正确 的 结果 前 必须 重复 动作 
或 断言 ( assertions ) 处 理 ， 不 这 样 的 话 Selenium 就 会 和 浏览 器 的 
画面 显示 速度 持续 竞争 。 


How to Lose Races and Win at Selenium ( http://sauceio.com/index.php/2011/04/ 





how-to-lose-races-and-win-at-seleniumy ) 





即 命令 执行 失败 时 ， 重 复 执 行 该 命令 多 次 ， 直 到 正常 运行 为 止 。 

但 是 用 通过 Selenium IDE 做 成 的 HTML 形式 的 测试 用 例 进行 测试 
的 情况 下 ， 是 由 Selenium Server 来 解析 测试 用 例 并 操作 浏览 器 的 ， 因 此 
不 修改 Selenium Server 的 代码 就 无 法 实现 “重复 数 次 执行 该 命令 直到 正 
常 运 行为 止 "。 若 要 重复 地 实施 处 理 ， 就 需要 通过 编程 语言 ( Java、 
Ruby、Python、Perl ) 来 制作 测试 用 例 ， 自 己 添加 重复 处 理 。 
下 面 介绍 在 用 Selenium IDE 制作 测试 用 例 的 情况 下 ， 应 该 如 何 加 入 
重复 处 理 。 按 照 下 述 步骤 就 可 以 修改 从 Selenium IDE 导出 的 测试 脚本 中 
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的 任意 一 条 命令 。 


@ 打开 Selenium IDE 的 “Option” 一 “Option...” 一 “Formats” 
标签 

@ 选择 作为 例子 所 使 用 的 格式 ( Java/JUnit4/RemoteControl 等 )， 
点 击 source 按键 ,复制 所 显示 的 代码 

@ 点 击 Add 按键 ， 将 步骤 2 复制 的 代码 粘贴 上 去 ， 对 需要 修改 的 
地 方 进行 修改 

@ 输入 格式 名 称 并 保存 

@@ 重启 Selenium IDE 和 Firefox 

@ 以 步骤 4 做 成 的 格式 导出 测试 用 例 








将 代码 清单 7.3 修改 为 代码 清单 7.4 那 样 ， 就 可 以 反复 执行 确认 画 
面 中 的 文字 内 容 是 否 显示 的 verifyTextPresent 命 令 。 
































代码 清单 7.3 修改 前 的 代码 


function verifyTrue (expression) { 
return "verifyTrue(" + expression.toString() + "™);"; 


} 


代码 清单 7.4 ”修改 后 的 代码 


function verifyTrue (expression) { 
return "for (int second = 0;; second++) {\n" + 
"\tif (second >= 60) fail(\"timeout\");\n" + 
"\ttry { " + (expression.setup ? expression.setup() + " " : "")+ 
"if (assertTrue(" + expression.toString() + ")) break; } catch 
(Exception e) {}\n" + 
"\tThread.sleep(1000);\n" + 
"jNany 





这 样 就 能 导出 如 代码 清单 7.5 所 示 的 测试 脚本 。 在 该 测试 脚本 中 ， 
即使 画面 没有 显示 要 确认 的 文字 而 造成 assertTrue 失败 ， 经 过 一 定时 间 
后 还 会 重新 尝试 确认 。 
























































代码 清单 7.5 ”导出 后 的 测试 用 例 


for (int second = 0;; second++) { 
if (second >= 60) fail("timeout"); 
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Ery 

if (assertTrue (selenium.isTextPresent ("请 输入 ID、 密 码 "))) break; 
} catch (Exception e) {} 
Thread.sleep (1000); 














不 要 直接 使 用 Selenium IDE 制作 的 测试 用 例 或 以 某 种 格式 导出 的 测 
试 脚本 ,根据 测试 脚本 的 制作 方法 的 不 同 ， 确 实 能 够 减少 由 于 页 面 加 载 
时 间 所 造成 的 测试 失败 。 
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7.3 ”Jenkins 和 Selenium 的 协作 








使 用 Selenium 进行 测试 ， 测 试用 例 的 制作 会 大 大 加 快 。 但 是 随 着 测 
试用 例 的 增加 ， 把 握 测试 是 否 被 正确 执行 、 测 试 是 否 通 过 ， 也 将 变 得 非 
常 麻烦 。 

对 于 这 样 的 问题 ， 第 5 章 中 所 介绍 的 Jenkins 这 样 的 CI 工具 就 非常 
有 用 。CI 工 具 可 以 实现 测试 的 实施 以 及 结果 的 品质 状况 可 视 化 ， 并 帮助 
团队 间 共 享 信息 。 

















7.3.1 关联 Jenkins 和 Selenium 的 步骤 





下 面 将 介绍 由 Jenkins 执行 Selenium 测试 用 例 的 方法 。 
用 Selenium IDE 制作 Selenium 的 测试 用 例 并 保存 为 HTML 格式 的 
话 ， 通 过 使 用 Jenkins 的 “Seleniumhq Plugin”， 从 Jenkins 执行 HTML 
测试 用 例 时 的 任务 设置 、 测 试 结果 报告 的 设置 都 将 变 得 非常 简单 。 

我 们 一 起 来 看 一 下 使 用 “Seleniumhq Plugin” 的 配置 方法 、 测 试 执 
行 以 及 测试 结果 的 确认 。 这 里 以 在 运行 有 Jenkins 的 机 器 上 执行 
Selenium 测试 为 前 提 进 行 讲解 。 
















































































@ 在 执行 测试 的 机 器 上 ， 从 版 本 管理 系统 下 载 测试 套件 和 测试 
用 例 ” 

@ 在 执行 测试 的 机 器 上 下 载 Selenium Server ” 

@ 从 Jenkins 的 “系统 管理 ”一 “管理 插件 ”安装 “Seleniumhdq 
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Plugin 





四 请 参考 5.4 节 中 “下 载 代码 ”部 分 的 内 容 。 
@) Selenium Server 的 下 载 用 Chef 来 实现 ， 请 参考 第 6 章 。 
@) https://wikijenkins-ci.org/display/JENKINS/Seleniumhq+Plugin 
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@ 在 Jenkins 的 “系统 管理 ”一 “系统 设置 ”中 设置 “Selenium 
Remote Control” 下 的 “htmlSuite Runner”( 图 7.10 ) 
设置 为 步骤 四 中 下 载 的 Selenium Server 的 路 径 


图 7.10 Selenium Server 的 设置 画面 





Selenium Remote Control 





htmlSuite Runner |c:\selenium\selenium-server.jar @ 








selenium-server.jar path 
@ 新 建 测试 用 的 Jenkins 任务 ， 任 务 的 “配置 ”如 下 
加 -1 在 “构建 ”下 的 “增加 构建 步 又 ”中 选择 “SeleniumHQhtmlSuite 
Run”， 按 照 表 7.1 进行 设置 (图 7.11 ) 














表 闻 可 SeleniumHQ htmlSuite Run 的 设置 












































项 目 说 明 

browser 设置 执行 测试 的 浏览 器 ( Firefox 的 话 是 *firefox ) 
startURL 浏览 器 启动 时 打开 的 URL 

suiteFile 设置 步骤 @ 中 准备 的 测试 套件 

resultFile 设置 测试 结果 的 输出 文件 名 ( ex.results.html ) 

















图 7.11 ”Selenium 测试 任务 的 配置 画面 


构建 








SeleniumHQ htmlSuite Run 
browser 





*firefox 





startURL [http://example.com 





suiteFile [C:\testcase\testsuiteO1.html 





resultFile |results.html 





图 图 图 图 图 





other 





前 除 











加 -2 选择 “构建 后 操作 ”下 “增加 构建 后 操作 步骤 ”中 的 “Puplish 
Selenium Report"， 按 照 表 7.2 进行 设置 (图 7.12 ) 
二 7 多 构建 后 的 处 理 


项 目 说 明 
Test report HTMLs 引 定 报告 的 保存 格式 ( ex.*.html ) 
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图 7.12 ”Selenium 测 试 结果 的 设 定 画 再 























构建 后 操作 


3 Publish Selenium Report @ 





Test report HTMLs [*-html | 


Flleset 'Includes' setting that specifies the generated raw HTML report files, such as 
'myproject/target/test-reports/*.html'. Basedir of the fileset |s the workspace root. 


删除 











加 -3 选择 “构建 后 操作 ”下 “增加 构建 后 操作 步 又 ”中 的 
“Archive the artifacts”， 按 照 表 7.3 进行 设置 (图 7.13 ) 








#2 0 构建 后 的 处 理 


项 目 说 明 
用 于 存档 的 文件 指定 保存 文件 的 格式 ( ex.*.html ) 























7.13 ”Selenium 测试 结果 的 保存 画面 





; Archive the avtifacts 





© 
用 于 存档 的 文件 。 [x.html 图 


高 级 


配置 完成 后 ， 试 着 执行 Jenkins 的 任务 下 的 “立即 构建 "。 配 置 正 确 
的 话 会 启动 Firefox 并 开始 测试 ，Selenium 测试 最 后 会 输出 测试 结果 报 
告 (图 7.14)。 

当然 也 可 以 通过 Jenkins 确认 测试 的 结果 ， 试 着 从 Jenkins 任务 画面 
左 侧 的 Build History 打开 本 次 执行 的 链接 。 构 建 #8 前 面 的 O 的 颜色 是 
蓝 色 的 话 表 示 构 建成 功 ， 若 是 红色 则 表示 构建 失败 ( 图 7.15 )。 
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7.14 ”Selenium 测试 执行 过 程 中 的 画面 





TI testcase2 Selenium TestRunner 
testcasel open http://www seleniumhaq orWdocw fwecvpe Tests 
testcase2 pbs) Lp 二 
人 
Mp cer 


romgete 
oom 
CT 
. 1 

Test Suite Current Test Control Panel 
Selenium 
cn mr 
For more Information on Selenlum, visit S 

Mtp://seleniunha.org e 





Se SeleniumHQ 


omweer MAomasor 








Nevigation Pregremmvre Lergvege Preteremee (BY cop ree or pe et arr 
Seteraer Oo encation 
me Selenium Documentation 
Conteres 

Mote to Ihe Reecer- Oocs peng . Mote to he esder-Oocs Seg Ad tor See 之 多 
Mevyoed for Setemen 2.0' -) 

or wee Acorereor 
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7.15 ”Jenkins 的 构建 结果 画面 


Jenkins 上 SampleSeleniumJob » #8 














返回 到 工程 


wa 和 构建 #8 (2013/11/17 16:56:12) 

















ee 构建 结果 
编辑 编译 信息 国 results.html ”2.53 KB 总 老 昭 


图 型 队 本 次 生成 








Selenium Report 没有 变化 
帮 前 一 次 构建 
由 匿名 用 户 触发 


为 numTestPasses: 2, numTestFailures: 0 
e 


可 以 从 “构建 结果 ”来 确认 Selenium 的 执行 结果 (图 7.16 )。 测试 
失败 时 可 以 从 这 个 Selenium 的 执行 结果 或 “Console Output” 查 看 失败 
的 原因 。 
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口 





归 测试 





7.16 ”Jenkins 的 Selenium 测试 结果 画面 


Test suite results 





result: passed 
totalTime: 有 
numTestTotal: 2 
numTestPasses: 2 
numTestFailures: 0 
numCommandPasses: 0 
numCommandFailures: 0 
numCommandErrors: 0 
Selenium Version: 2 
Selenium Revision: :0 
Test Suite 

testcasel 

testcase2 

testcasel1 .html 

testcasel 

open http://www.seleniumhq.org/ 
testcase2.html 

testcase2 

open http://www.seleniumhq.org/docs/ 
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7.4 Selenium 测试 的 高 速 化 





之 前 已 经 多 次 提 到 ，Selenium 的 测试 中 经 常会 出 问题 的 就 是 测试 的 
速度 。Selenium 的 测试 是 从 使 用 浏览 器 的 系统 用 户 的 观点 出 发 的 集成 测 
试 ， 加 上 Selenium 自身 的 速度 并 不 快 ， 因 此 和 单元 测试 相 比 的 确 是 非常 
耗费 时 间 的 测试 。 

另外 , 在 用 Selenium IDE 制作 测试 用 例 的 情况 下 ， 因 为 非常 简单 ， 
所 以 往往 容易 不 加 思索 地 对 各 处 进行 测试 ， 结 果 就 导致 执行 所 有 的 测试 
需要 耗费 大 量 的 时 间 。 

下 面 是 笔者 所 在 公司 的 Selenium 测试 套件 数量 的 演变 图 (图 7.17 ) 
和 所 有 测试 套件 执行 时 间 的 演变 图 ( 图 7.18 )。 随 着 自动 测试 的 不 断 增 
加 ， 执 行 所 有 测试 甚至 要 花费 数 日 之 久 。 


图 7.17 ”Selenium 测试 套件 数量 的 演变 
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图 7.18 ”Selenium 测试 执行 时 间 的 演变 
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习 动 测试 的 强化 

















作为 上 述 问题 的 有 效 解 决 方案 ， 本 节 将 介绍 并 行 执行 测试 的 方法 。 





7.4.1 利用 Jenkins 的 分 布 式 构建 实现 测试 的 并 行 执行 


首先 ， 正 如 之 前 在 “好 的 测试 用 例 ” 一 节 中 所 讲 的 那样 ， 开 始 并 行 
执行 测试 时 ， 各 个 测试 套件 必须 不 相互 依赖 ， 能 够 单独 通过 测试 。 在 此 


基础 上 再 利用 Jenkins ， 即 可 构建 并 行 执行 的 机 甫 





























下 





O 


Jenkins 提供 了 “分 布 式 构建 ”这 一 功能 强大 的 机 制 来 支持 并 行 测 
试 。 这 里 对 基于 上 述 机 制 的 并 行 执行 进行 讲解 。 











@…… Jenkins 的 分 布 式 构建 的 构成 
利用 Jenkins 的 “分 布 式 构建 ”机 制 能 够 组 建 从 数 十 台 到 数 百 台 机 


如 的 集群 (图 7. 


19 )。 
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图 7.19 ”Jenkins 的 主 ( master ) 和 从 ( slave ) 结构 








从 服务 器 N 











各 台 机 需 根据 功能 的 不 同 分 为 master 和 slave 两 种 。 安 装 有 Jenkins 
的 机 器 作为 master 负责 各 种 配置 信息 的 管理 、 构 建 时 处 理 流程 的 控制 ， 
以 及 调度 各 slave 实施 处 理 等 。 

slave 从 master 接收 指令 ， 从 版 本 管理 系统 上 取得 、 更 新 代码 或 测 
试用 例 并 执行 测试 。 


@…… 分 布 式 构建 的 配置 


接着 就 让 我 们 试 着 实际 构建 一 下 Jenkins 的 master 和 slave 架构 。 这 
里 以 Windows 平台 为 例 讲 解 slave 的 架构 。 

















@ 配置 slave 机 器 的 Jenkins 
从 Jenkins 的 “系统 管理 ”一 “管理 节点 ”一 “新 建 节 点 ”开始 
新 建 slave 节点 ( 图 7.20 )。slave 的 种 类 选择 “Dumb Slave”。 其 他 项 
目的 设置 如 表 7.4 所 示 。 
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7.20 ”配置 slave 机 器 的 Jenkins 



































者 Jenkins 
Jenkins nodes slave-node1 
会 返回 列表 Name selenium-clientt 加 
息 状态 描述 © 
人 出 除 子 节点 
# of executors 3 2 © 
尖 配置 从 节点 
时 构建 历史 远程 工作 目录 | cyenkins © 
负载 统计 标签 windows © 
国 由 本 命 信行 
用 法 ey 
自 w 尽 可 能 的 使 用 这 个 节点 -Je 
启动 方法 Launch slave agents via Java Web Start | © 
构建 执行 状态 = 
高 级 
Availabilty | [eap his slave Onine as muoh as possible 了 de 
Node Properties 
Environment variables 
Tool Locations 
表 7.4 ”slave 的 设置 
项 目 说 明 
Name 设置 slave 节点 的 名 称 。 以 slave 的 计算 机 名 来 命名 简洁 易 懂 
描述 设置 节点 的 描述 

















of executors | 设置 slave 机 器 上 能 够 同时 构建 的 任务 数量 。 可 以 先 设置 为 3 或 5， 
确认 执行 测试 时 的 负载 后 再 进行 调整 
远程 工作 目录 | slave 机 器 上 Jenkins 的 根 且 录 。 可 以 设置 为 cNenkins 等 






























































































































































标签 可 以 为 各 slave 机 器 标注 标签 。 输 入 例如 “windows” 这 样 提示 
slave 特征 的 标签 
法 指定 构建 的 调度 方法 。 设 置 为 默认 的 “ 尽 可 能 使 用 这 个 节点 ” 
启动 方法 选择 “Launch slave agents via Java Web Start” 
Availability 指定 slave 的 可 用 性 。 设 置 为 默认 的 “Keep this slave on-line as 


























much as possible” 





@ master 和 slave 的 连接 
从 新 添加 的 Windows 节点 的 浏览 器 打开 Jenkins， 点 击 步 又 @@ 中 建 
立 的 slave 画面 上 的 “Launch” 键 ， 就 能 下 载 JNLP 文 件 。 运 行 该 
JNLP 文件 ， 就 会 安装 作为 slave 节点 所 需要 的 文件 ， 并 连接 master。 
Windows 会 因为 Windows update 而 频繁 地 重启 ， 因 此 要 进行 如 下 设置 。 
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@ 将 下 载 的 JNLP 文件 存放 到 启动 目录 下 
@ 设置 为 自动 登录 


全 配置 测试 任务 在 哪个 slave 上 执行 

在 各 任务 配置 的 “Restrict where this project can be run”( 图 7.21 ) 
中 指定 让 哪个 slave 来 执行 构建 处 理 。 这 里 可 以 十 人 步骤 人 @ 中 设置 的 
slave 节点 名 、slave 的 标签 ， 或 者 标签 和 催 辑 运算 符 (&& 或 | 等 ) 
的 组 合 ， 由 符合 这 里 设 定 的 限制 条 件 的 slave 节点 之 一 来 执行 构建 处 
理 。 可 以 直接 在 “Restrict where this project can be run” 设 置 slave 节点 
名 ,但 这 并 不 是 聪明 的 方法 ， 因 为 随 着 测试 任务 的 增加 ， 特 定 slave 的 
负担 加 重 ， 即 使 构建 了 分 布 式 的 环境 ， 但 因为 限制 了 特定 的 slave， 也 
会 造成 无 法 顺利 均衡 负载 。 因 此 理想 的 方法 是 使 用 slave 的 标签 。 
































图 7.21 配置 测试 任务 在 哪个 slave 上 执行 














回 Restrict where this project can be run @ 
人 |windows 局 
@@ 执行 构建 


点 击 Jenkins 任务 的 “立即 构建 ”就 会 启动 slave 机 器 执行 测试 。 
这 样 分 布 式 构建 环境 的 构筑 就 完成 了 。 





7.4.2 Selenium 测试 并 行 化 中 的 难点 


至 此 ， 我 们 讲解 了 为 了 尽快 完成 测试 ， 实 现 Selenium 测试 的 高 速 
化 ， 测 试用 例 应 该 符合 哪些 条 件 ， 以 及 并 行 执行 多 个 测试 用 例 的 方法 。 

这 里 再 介绍 一 下 笔者 所 在 公司 并 行 执行 测试 时 所 发 生 的 问题 。 虽 然 
在 多 数 系统 上 该 问题 未 必 会 发 生 ， 但 可 以 为 解决 推进 Selenium 测试 并 行 
化 过 程 中 的 若干 问题 提供 一 些 启示 。 

在 之 前 的 “使 Selenium 测试 稳定 运行 ”这 一 小 节 中 ， 我 们 介绍 了 
Selenium 会 无 视 当 前 页 面 内 容 是 否 加 载 完 成 ， 而 直接 继续 下 面 的 测试 ， 
因而 造成 了 系统 虽然 正常 运行 但 测试 依然 失败 的 情况 。 造 成 这 种 现象 的 
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原因 可 能 是 服务 器 正在 备份 或 解析 日 志 等 而 造成 服务 器 的 负载 变 高 。 

同样 ， 并 行 执行 测试 也 会 引发 新 的 问题 ， 那 就 是 并 行 执行 会 启动 多 
个 浏览 器 ， 这 些 浏览 器 的 请 求 会 集中 发 往 特定 的 服务 器 ， 这 样 该 服务 器 
的 响应 就 会 变 得 缓慢 。 

根据 上 述 方法 并 行 执行 Selenium 测试 的 情况 下 ，Jenkins 任务 中 指 
定 的 slave 或 标签 就 是 会 启动 浏览 器 的 机 器 。 上 述 方法 可 以 实现 运行 浏 
览 器 的 机 器 的 负载 均衡 ， 但 无 法 实现 从 浏览 器 接收 请 求 的 服务 器 的 负载 
均衡 (图 7.22 )。 


7.22 ”Selenium 测试 并 行 执行 时 的 请 求 不 均衡 





































































































这 个 问题 虽 不 会 造成 测试 失败 频繁 发 生 ， 但 在 运行 系统 的 服务 器 配 
置 较 低 或 系统 的 处 理 能 力 较 差 等 情况 下 就 很 容易 造成 这 样 的 问题 。 

对 于 上 述 问题 ， 我 们 采取 的 对 策 是 将 浏览 器 客户 端 和 运行 系统 的 服 
务 器 进行 1: 1 配对 (图 7.23 )， 包 括 应 用 程序 用 到 的 服务 器 端的 缓存 服 
务 器 以 及 数据 库 服 务 器 等 ， 都 和 浏览 需 客 户 端 组 成 1 个 配对 ， 通 过 增加 
浏览 需 客 户 端 和 服务 器 端的 配对 形式 来 扩展 测试 的 规模 。 

要 使 浏览 需 客 户 端 和 服务 需 进 行 1 : 1 的 配对 ， 就 需要 替换 各 个 机 器 
上 的 hosts 文件 ， 使 其 向 特定 的 机 咒 发 送 请 求 (图 7.24 )。 例 如， 替换 浏览 
器 客户 端 机 器 上 的 hosts 文件 ， 使 其 向 对 应 的 应 用 程序 服务 器 发 送 请 求 。 

这 样 特定 机 器 上 运行 的 浏览 器 的 请 求 就 会 发 往 特定 的 服务 器 进行 处 
理 。 服 务 顺 端 也 一 样 ， 固 定 服务 器 上 运行 的 应 用 程序 会 使 用 其 对 应 的 数 
据 库 服务 器 。 
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图 7.23 1: 1 的 浏览 器 客户 端 和 服务 器 的 结构 
浏览 呈 程序 
( 客户 端 C ) ( 服务 器 端 
图 7.24 ”hosts 文件 的 修改 











192:168.1.10 
192:168.111 
192:168:1212 
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192.168.1.211 
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户 端 A 的 hosts 文件 


test1.example.com 
test2.example.com 
test3.example.com 


客户 端 B 的 hosts 文件 
192.168.1.110 test1.example.com 
test2.example.com 
test3.example.com 


户 端 C 的 hosts 文件 


test1.example.com 
test2.example.com 
test3.example.com 








如 上 所 述 , 使 用 Selenium 进行 的 是 集成 测试 ， 所 以 和 单元 测试 的 并 
行 执行 不 同 ， 浏 览 器 端的 机 器 、 服 务 咒 端的 机 需 或 数据 库 服务 器 等 ， 其 
中 任意 一 项 的 高 负载 都 会 造成 测试 不 稳定 。 根 据 具 体 的 原因 处 理 方法 也 
有 所 不 同 。 在 推进 测试 的 并 行 执行 过 程 


题 之 一 o 
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P， 机 器 的 负载 是 需要 注意 的 问 
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7.5 ”多 个 应 用 程序 版 本 的 测试 











第 3 章 中 介绍 了 灵活 运用 版 本 管理 系统 是 顺利 进行 团队 开发 所 必 不 
可 少 的 要 素 。 当 然 不 仅 是 代码 ， 测 试用 例 也 应 该 进行 版 本 管理 。 这 样 就 
可 以 对 系统 的 多 个 版 本 进行 测试 ， 其 优点 有 如 下 这 些 。 





吾 











e@ 在 发 布 后 的 版 本 中 发 现 bug， 需 要 紧急 发 布 的 情况 下 ， 如 果 能 
实施 自动 化 测试 ， 就 能 够 安心 地 发 布 

@ 能 够 和 紧急 发 布 的 测试 并 行进 行 下 一 次 发 布 的 开发 工作 

@ 每 个 开发 团队 在 不 同 的 分 支 上 开发 的 情况 下 ， 可 以 在 该 分 支 上 执 
行 其 对 应 的 测试 用 例 ， 在 向 主 代码 库 提 交 之 前 实施 自动 测试 


这 里 介绍 一 下 对 多 个 版 本 进行 Selenium 测试 的 方法 (图 7.25 ) 首先 ， 
用 Jenkins 的 “Parameterized Trigger pluguin” 来 指定 对 哪个 版 本 执行 测试 。 
假设 这 里 设置 的 变量 名 字 为 APP_VERSION， 那 么 在 Jenkins 的 任务 配置 中 ， 
用 名 为 ${RAPP_VERSION } 的 变量 就 能 在 构建 时 取得 指定 的 版 本 。 


7.25 ”对 多 个 版 本 进行 Selenium 测试 
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7.5.1 应 用 的 部 署 


通常 ， 对 应 用 程序 的 多 个 版 本 进行 单元 测试 时 ， 只 需要 将 代码 变更 
为 特定 的 版 本 就 可 以 进行 测试 了 。 而 Selenium 测试 则 需要 从 部 署 应 用 程 
序 的 特定 版 本 开始 着 手 。 因 此 ， 测 试 的 整体 流程 可 分 为 “部 署 应 用 程 
序 ” 和 “用 Selenium 测试 "。 可 以 使 用 Jenkins 的 构建 流水 线 或 任务 关联 
等 来 构筑 这 样 的 流程 。 









































7.5.2 ”从 版 本 管理 系统 下 载 测 试用 例 

接着 从 版 本 管理 系统 上 下 载 测试 用 例 。 当 然 前 提 是 测试 用 例 和 代码 
一 样 都 进行 了 版 本 管理 。 

在 Jenkins 的 测试 任务 的 工作 目录 下 ， 以 各 版 本 为 目录 名 保存 测试 用 
例 (图 7.26 )。 使 用 Git 管理 代码 的 情况 下 ， 可 以 将 Git 插件 的 “高 级 ”下 
的 “Local subdirectory for repo ( optional ”设置 为 “TestSuite/S{APP 
VERSION}”。 如 果 忘 记 进行 上 述 配置 ， 各 版 本 的 测试 用 例 就 会 被 直接 下 
载 到 测试 任务 的 工作 目录 下 ， 和 其 他 版 本 的 测试 用 例 混 在 一 起 ， 因 此 需 
要 特别 注意 。 


















































7.5.3 用 Selenium 测试 





正如 7.3 节 中 讲解 的 那样 ， 只 需 在 “seleniumhq Plugin” 的 suiteFile 
中 设置 刚才 下 载 的 测试 套件 ， 即 可 执行 测试 。 可 以 将 suiteFile 设置 为 
“${NWORKSPACE } /TestSuite/S{APP VERSION}/login.html” 
这 样 就 可 以 对 多 个 版 本 进行 测试 了 。 
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7.26 ”保存 各 版 本 的 测试 用 例 











TestSuite 


login.html 
login_successful.html 


login_failed.html 


login.html 
login_successful.html 
login_failed.html 
user.html 


create_user.html 
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7.6 本章 总 结 


如 本 章 所 述 ， 自 动 化 的 回归 测试 能 够 使 发 生 退 化 bug 的 风险 最 小 
化 ， 同 时 又 是 能 快速 、 持 续 地 进行 功能 添加 和 改善 的 有 效 手段 。 除 此 之 
外 ， 本 章 还 介绍 了 作为 其 工具 的 浏览 器 驱动 测试 工具 Selenium， 以 及 为 
了 高 效 地 实施 Selenium 测试 而 进行 的 Selenium 和 Jenkins 之 间 的 关联 。 
回归 测试 不 仅 是 开发 人 员 实 施 的 单元 测试 ， 还 包括 从 用 户 视角 进行 
的 集成 测试 、 用 户 验 收 测试 。 在 持续 的 系统 版 本 更 新 时 ， 这 些 是 非常 强 
有 力 的 测试 手段 。 

但 是 要 补充 一 下 ， 回 归 测 试 的 自动 化 未 必 会 使 测试 代码 减少 。 使 
Selenium 的 测试 自动 化 有 时 会 需要 大 量 的 维护 工作 。 也 有 比较 适合 进行 
手动 测试 的 情况 。 因 此 在 制作 自动 化 测试 时 ， 可 以 先 思考 一 下 正 要 制作 
的 测试 今后 会 被 执行 几 次 ， 今 后 需要 怎样 的 维护 等 。 
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员工 : “老板 ,我 要 加 工资 !” 


老板 : “为 什么 ? ” 
员工 : “因为 我 长 得 帅 ! ” 
老板 “……” 


员工 : “因为 我 跟 你 10 年 了 , 没有 功劳 也 有 若 劳 吧 ! ” 
老板 : nai, 加 5% 差 不 多 了 。” 
员工 : “这 个 项 目 交 给 我 , 我 有 办 法 只 需要 一 半 的 人 手 就 能 完成 ! ” 
老板 : “ 真 的 ? 好 ! 工资 翻 倍 ! ” 
一 一 摘自 本 书 译 者 序 


人 重要 的 邮件 太 多 而 无 从 下 手 他 没有 能 用 于 验证 的 环境 
他 覆盖 了 其 他 组 员 修 正 的 代码 ””( 无 法 自信 地 进行 代码 重 构 
办 不 知道 pug 的 修正 日 期 ， 也 不 能 追踪 退化 …… 
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太 自动 化 意识 贯穿 全 书 ， 真 正 实现 高 效 开 发 
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